supermemory 3.0.0a28__py3-none-any.whl → 3.0.0a30__py3-none-any.whl

supermemory/types/search_documents_params.py

@@ -5,6 +5,7 @@ from __future__ import annotations
 from typing import Dict, List, Union, Iterable
 from typing_extensions import Literal, Required, Annotated, TypeAlias, TypedDict
 
+from .._types import SequenceNotStr
 from .._utils import PropertyInfo
 
 __all__ = ["SearchDocumentsParams", "Filters", "FiltersUnionMember0"]
@@ -26,11 +27,11 @@ class SearchDocumentsParams(TypedDict, total=False):
     (returns lesser chunks, accurate results)
     """
 
-    container_tags: Annotated[List[str], PropertyInfo(alias="containerTags")]
+    container_tags: Annotated[SequenceNotStr[str], PropertyInfo(alias="containerTags")]
     """Optional tags 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.
+    to use to filter documents.
     """
 
     doc_id: Annotated[str, PropertyInfo(alias="docId")]

supermemory/types/search_execute_params.py

@@ -5,6 +5,7 @@ from __future__ import annotations
 from typing import Dict, List, Union, Iterable
 from typing_extensions import Literal, Required, Annotated, TypeAlias, TypedDict
 
+from .._types import SequenceNotStr
 from .._utils import PropertyInfo
 
 __all__ = ["SearchExecuteParams", "Filters", "FiltersUnionMember0"]
@@ -26,11 +27,11 @@ class SearchExecuteParams(TypedDict, total=False):
     (returns lesser chunks, accurate results)
     """
 
-    container_tags: Annotated[List[str], PropertyInfo(alias="containerTags")]
+    container_tags: Annotated[SequenceNotStr[str], PropertyInfo(alias="containerTags")]
     """Optional tags 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.
+    to use to filter documents.
     """
 
     doc_id: Annotated[str, PropertyInfo(alias="docId")]

supermemory/types/search_memories_response.py

@@ -71,17 +71,20 @@ class ResultDocument(BaseModel):
     created_at: datetime = FieldInfo(alias="createdAt")
     """Document creation date"""
 
+    updated_at: datetime = FieldInfo(alias="updatedAt")
+    """Document last update date"""
+
     metadata: Optional[Dict[str, object]] = None
-    """Document metadata"""
+    """Document metadata (only included when documents=true)"""
 
-    title: str
-    """Document title"""
+    summary: Optional[str] = None
+    """Document summary (only included when summaries=true)"""
 
-    type: str
-    """Document type"""
+    title: Optional[str] = None
+    """Document title (only included when documents=true)"""
 
-    updated_at: datetime = FieldInfo(alias="updatedAt")
-    """Document last update date"""
+    type: Optional[str] = None
+    """Document type (only included when documents=true)"""
 
 
 class Result(BaseModel):

{supermemory-3.0.0a28.dist-info → supermemory-3.0.0a30.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: supermemory
-Version: 3.0.0a28
+Version: 3.0.0a30
 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
@@ -162,23 +162,6 @@ response = client.search.memories(
 print(response.include)
 ```
 
-## File uploads
-
-Request parameters that correspond to file uploads can be passed as `bytes`, or a [`PathLike`](https://docs.python.org/3/library/os.html#os.PathLike) instance or a tuple of `(filename, contents, media type)`.
-
-```python
-from pathlib import Path
-from supermemory import Supermemory
-
-client = Supermemory()
-
-client.memories.upload_file(
-    file=Path("/path/to/file"),
-)
-```
-
-The async client uses the exact same interface. If you pass a [`PathLike`](https://docs.python.org/3/library/os.html#os.PathLike) instance, the file contents will be read asynchronously automatically.
-
 ## Handling errors
 
 When the library is unable to connect to the API (for example, due to network connection problems or a timeout), a subclass of `supermemory.APIConnectionError` is raised.
@@ -195,7 +178,9 @@ from supermemory import Supermemory
 client = Supermemory()
 
 try:
-    client.memories.add()
+    client.search.documents(
+        q="machine learning concepts",
+    )
 except supermemory.APIConnectionError as e:
     print("The server could not be reached")
     print(e.__cause__)  # an underlying Exception, likely raised within httpx.
@@ -238,7 +223,9 @@ client = Supermemory(
 )
 
 # Or, configure per-request:
-client.with_options(max_retries=5).memories.add()
+client.with_options(max_retries=5).search.documents(
+    q="machine learning concepts",
+)
 ```
 
 ### Timeouts
@@ -261,7 +248,9 @@ client = Supermemory(
 )
 
 # Override per-request:
-client.with_options(timeout=5.0).memories.add()
+client.with_options(timeout=5.0).search.documents(
+    q="machine learning concepts",
+)
 ```
 
 On timeout, an `APITimeoutError` is thrown.
@@ -302,11 +291,13 @@ The "raw" Response object can be accessed by prefixing `.with_raw_response.` to
 from supermemory import Supermemory
 
 client = Supermemory()
-response = client.memories.with_raw_response.add()
+response = client.search.with_raw_response.documents(
+    q="machine learning concepts",
+)
 print(response.headers.get('X-My-Header'))
 
-memory = response.parse()  # get the object that `memories.add()` would have returned
-print(memory.id)
+search = response.parse()  # get the object that `search.documents()` would have returned
+print(search.results)
 ```
 
 These methods return an [`APIResponse`](https://github.com/supermemoryai/python-sdk/tree/main/src/supermemory/_response.py) object.
@@ -320,7 +311,9 @@ The above interface eagerly reads the full response body when you make the reque
 To stream the response body, use `.with_streaming_response` instead, which requires a context manager and only reads the response body once you call `.read()`, `.text()`, `.json()`, `.iter_bytes()`, `.iter_text()`, `.iter_lines()` or `.parse()`. In the async client, these are async methods.
 
 ```python
-with client.memories.with_streaming_response.add() as response:
+with client.search.with_streaming_response.documents(
+    q="machine learning concepts",
+) as response:
     print(response.headers.get("X-My-Header"))
 
     for line in response.iter_lines():

supermemory-3.0.0a30.dist-info/RECORD

@@ -0,0 +1,60 @@
+supermemory/__init__.py,sha256=PDWpv0_OWO8lBFh21lQl5k0zrlBzcGf643CKXRoQgzM,2664
+supermemory/_base_client.py,sha256=bK0ae9oSv0vJ1OlcKMUbe3nqB_4chN9pI1EFiHpt0v4,67052
+supermemory/_client.py,sha256=XCDomFBEKkDLBYTs6tx0yXho0VeFjSsrAnuc_6aOwVA,16328
+supermemory/_compat.py,sha256=DQBVORjFb33zch24jzkhM14msvnzY7mmSmgDLaVFUM8,6562
+supermemory/_constants.py,sha256=S14PFzyN9-I31wiV7SmIlL5Ga0MLHxdvegInGdXH7tM,462
+supermemory/_exceptions.py,sha256=5nnX7W8L_eA6LkX3SBl7csJy5d9QEcDqRVuwDq8wVh8,3230
+supermemory/_files.py,sha256=KnEzGi_O756MvKyJ4fOCW_u3JhOeWPQ4RsmDvqihDQU,3545
+supermemory/_models.py,sha256=c29x_mRccdxlGwdUPfSR5eJxGXe74Ea5Dje5igZTrKQ,30024
+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=QjJ-KUf9LVQjcoSDmaE5HGS-JPjxSqPr6_xQZrMisig,7301
+supermemory/_version.py,sha256=3k6HeAMc3BROEEY8fsfJTLdhgARmjiA2lSD1sQNNdKA,172
+supermemory/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+supermemory/_utils/__init__.py,sha256=7fch0GT9zpNnErbciSpUNa-SjTxxjY6kxHxKMOM4AGs,2305
+supermemory/_utils/_compat.py,sha256=D8gtAvjJQrDWt9upS0XaG9Rr5l1QhiAx_I_1utT_tt0,1195
+supermemory/_utils/_datetime_parse.py,sha256=bABTs0Bc6rabdFvnIwXjEhWL15TcRgWZ_6XGTqN8xUk,4204
+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=i_U4R82RtQJtKKCriwFqmfcWjtwmmsiiF1AEXKQ_OPo,15957
+supermemory/_utils/_typing.py,sha256=N_5PPuFNsaygbtA_npZd98SVN1LQQvFTKL6bkWPBZGU,4786
+supermemory/_utils/_utils.py,sha256=D2QE7mVPNEJzaB50u8rvDQAUDS5jx7JoeFD7zdj-TeI,12231
+supermemory/lib/.keep,sha256=wuNrz-5SXo3jJaJOJgz4vFHM41YH_g20F5cRQo0vLes,224
+supermemory/resources/__init__.py,sha256=GE_4JaZjfSY6B2WaoTqQ5C52tloAwBOww-1YK4roV_M,1543
+supermemory/resources/connections.py,sha256=3F0qoyl_P8eNUJ1u1E_RBl7DEIFIn0QRm5vLNxn2T1s,33321
+supermemory/resources/search.py,sha256=nL8VOpD9uyzWazOIsKmknuZiXrdYtEQ4vi6Jka6x2ao,28557
+supermemory/resources/settings.py,sha256=tLM7ya1CEYI_TO8DMP_KLxXHqsxOeq3R3Xs4CQnvPuU,11855
+supermemory/types/__init__.py,sha256=RmM24Xsd97VINnZ5XdTim-9L3oh-8kt-pYAn-UOQyZ0,2276
+supermemory/types/connection_create_params.py,sha256=nhbXyd7hLyh7AuH4JrdfeWmiCj1H3YV22ycZzu4ggmk,670
+supermemory/types/connection_create_response.py,sha256=i4sb0DSRs7wVVd8xDBOtr7vw-YbaeZ7MydlQLYvlvJs,468
+supermemory/types/connection_delete_by_id_response.py,sha256=guD1vxqV2wiQnwnWCZSQH0z2HYXQOtvicRzouPVkHXA,243
+supermemory/types/connection_delete_by_provider_params.py,sha256=inmWn18C-FCevq-mcsIRzcHwT5BEcH9LqOrlifBtnSQ,550
+supermemory/types/connection_delete_by_provider_response.py,sha256=PgMQuSIhVFSF2LVa0FBei2bj3gyVRB7FyOi_-M-Rugc,255
+supermemory/types/connection_get_by_id_response.py,sha256=H0xkm41aGnhzN29iPWit9xMjTvKfgoE8BY5xDlEYNtU,650
+supermemory/types/connection_get_by_tags_params.py,sha256=c8u58EaxhEZrCERMix5H3lkVJqud0DIHd2Vsc8-mhok,526
+supermemory/types/connection_get_by_tags_response.py,sha256=EX5wP1PHFO5uurKiTacudDX3Syp65TUJLN2KVZrb9QE,654
+supermemory/types/connection_import_params.py,sha256=mUIuaeXLJe14_6vuFizs9sG_csibvQmn6eAdPll3pjA,510
+supermemory/types/connection_import_response.py,sha256=W3Jn98_wmYGSAr4H553uoiutdWL49-myc6MDa0mFEog,210
+supermemory/types/connection_list_documents_params.py,sha256=MBKSgfdV-Gx02DpV4ENk2ME8F1bz2JcXd7j6sYbooIk,522
+supermemory/types/connection_list_documents_response.py,sha256=0IdHufx0yErjfmoXYeY0KJ2QID9C-_58joyGEuu8gd4,682
+supermemory/types/connection_list_params.py,sha256=hg7wKFASpFqDnJ3Kycyziajimvx1p2q2fKJqfexxTF8,504
+supermemory/types/connection_list_response.py,sha256=D4mYePuR9NAGMDkbgDncN-KjulLXbCWDfRBvRDXSE58,795
+supermemory/types/search_documents_params.py,sha256=dvHbq4r_l5mGCfbKZ-Y8KQWK2ptLKXcW1-ZpEHKaqYc,3181
+supermemory/types/search_documents_response.py,sha256=dCQ1UUOALmfPqnUpX_-_kFbV4eHPFcuT1b7AVtLq5y4,1464
+supermemory/types/search_execute_params.py,sha256=0kVopvJnk67ZUWZspOi8s2mT0G6s1HXqllQPHEx-xBU,3177
+supermemory/types/search_execute_response.py,sha256=U1Fh4JX433A442Di9nnaQq6ts1olDdz3-SSbKzIFBPc,1460
+supermemory/types/search_memories_params.py,sha256=4SI8Z3ji_E_yqKmY5Nl-mL-7xODmRVV3TPsAeVefekU,1860
+supermemory/types/search_memories_response.py,sha256=FfYDXRccWjMSWi-2sqpM7WHrVk_v5AAypHTmCWC5LJY,3288
+supermemory/types/setting_get_response.py,sha256=WvgAb9zGMsMnAhLiYk6h5NBptnq0D06TnuoI4EJg5Ds,1648
+supermemory/types/setting_update_params.py,sha256=KsreaS35v25aRKBY5vHna3hZ31U3b1Q5ruQLoM0gcyE,1710
+supermemory/types/setting_update_response.py,sha256=F__RcFFWiiSw11IV8PsWn6POEb1crDwO8QwHEQToVuQ,1806
+supermemory-3.0.0a30.dist-info/METADATA,sha256=bWoyruqNraB47cSHY5kueRgrH8boSVwMtDTRnN-d_pY,14313
+supermemory-3.0.0a30.dist-info/WHEEL,sha256=C2FUgwZgiLbznR-k0b_5k3Ai_1aASOXDss3lzCUsUug,87
+supermemory-3.0.0a30.dist-info/licenses/LICENSE,sha256=M2NcpYEBpakciOULpWzo-xO2Lincf74gGwfaU00Sct0,11341
+supermemory-3.0.0a30.dist-info/RECORD,,