feat(api): manual updates

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 10
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/supermemory--inc%2Fsupermemory-a280bf0a406a709c156d5e3fe7c8ae93ebe607d937af8d725d0a2997cab07a7d.yml
-openapi_spec_hash: 15c602571db9cbcce4703c929b994d82
-config_hash: 1c771b2d30afc18bf405a425ea1c327a
+configured_endpoints: 11
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/supermemory--inc%2Fsupermemory-9f6d4050800c7cde90cbc3d1b59c782955e3cc1f73790c13a1924a000e09ec14.yml
+openapi_spec_hash: 92739eccad02248cc2bf07874e299fec
+config_hash: 3a000ea344f2f52c50cf06452fcf52ca

api.md

@@ -15,8 +15,8 @@ from supermemory.types import (
 Methods:
 
 - <code title="patch /v3/memories/{id}">client.memories.<a href="./src/supermemory/resources/memories.py">update</a>(path_id, \*\*<a href="src/supermemory/types/memory_update_params.py">params</a>) -> <a href="./src/supermemory/types/memory_update_response.py">MemoryUpdateResponse</a></code>
-- <code title="delete /v3/memories/{id}">client.memories.<a href="./src/supermemory/resources/memories.py">list</a>(id) -> <a href="./src/supermemory/types/memory_list_response.py">MemoryListResponse</a></code>
-- <code title="get /v3/memories/{id}">client.memories.<a href="./src/supermemory/resources/memories.py">delete</a>(id) -> <a href="./src/supermemory/types/memory_delete_response.py">MemoryDeleteResponse</a></code>
+- <code title="get /v3/memories">client.memories.<a href="./src/supermemory/resources/memories.py">list</a>(\*\*<a href="src/supermemory/types/memory_list_params.py">params</a>) -> <a href="./src/supermemory/types/memory_list_response.py">MemoryListResponse</a></code>
+- <code title="delete /v3/memories/{id}">client.memories.<a href="./src/supermemory/resources/memories.py">delete</a>(id) -> <a href="./src/supermemory/types/memory_delete_response.py">MemoryDeleteResponse</a></code>
 - <code title="post /v3/memories">client.memories.<a href="./src/supermemory/resources/memories.py">add</a>(\*\*<a href="src/supermemory/types/memory_add_params.py">params</a>) -> <a href="./src/supermemory/types/memory_add_response.py">MemoryAddResponse</a></code>
 - <code title="get /v3/memories/{id}">client.memories.<a href="./src/supermemory/resources/memories.py">get</a>(id) -> <a href="./src/supermemory/types/memory_get_response.py">MemoryGetResponse</a></code>
 

src/supermemory/resources/memories.py

@@ -3,10 +3,11 @@
 from __future__ import annotations
 
 from typing import Dict, List, Union
+from typing_extensions import Literal
 
 import httpx
 
-from ..types import memory_add_params, memory_update_params
+from ..types import memory_add_params, memory_list_params, memory_update_params
 from .._types import NOT_GIVEN, Body, Query, Headers, NotGiven
 from .._utils import maybe_transform, async_maybe_transform
 from .._compat import cached_property
@@ -95,8 +96,12 @@ def update(
 
     def list(
         self,
-        id: str,
         *,
+        filters: str | NotGiven = NOT_GIVEN,
+        limit: str | NotGiven = NOT_GIVEN,
+        order: Literal["asc", "desc"] | NotGiven = NOT_GIVEN,
+        page: str | NotGiven = NOT_GIVEN,
+        sort: Literal["createdAt", "updatedAt"] | NotGiven = NOT_GIVEN,
         # 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,
@@ -105,9 +110,19 @@ def list(
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> MemoryListResponse:
         """
-        Delete a memory
+        Retrieves a paginated list of memories with their metadata and workflow status
 
         Args:
+          filters: Optional filters to apply to the search
+
+          limit: Number of items per page
+
+          order: Sort order
+
+          page: Page number to fetch
+
+          sort: Field to sort by
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -116,12 +131,23 @@ def list(
 
           timeout: Override the client-level default timeout for this request, in seconds
         """
-        if not id:
-            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
-        return self._delete(
-            f"/v3/memories/{id}",
+        return self._get(
+            "/v3/memories",
             options=make_request_options(
-                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                query=maybe_transform(
+                    {
+                        "filters": filters,
+                        "limit": limit,
+                        "order": order,
+                        "page": page,
+                        "sort": sort,
+                    },
+                    memory_list_params.MemoryListParams,
+                ),
             ),
             cast_to=MemoryListResponse,
         )
@@ -138,7 +164,7 @@ def delete(
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> MemoryDeleteResponse:
         """
-        Get a memory by ID
+        Delete a memory
 
         Args:
           extra_headers: Send extra headers
@@ -151,7 +177,7 @@ def delete(
         """
         if not id:
             raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
-        return self._get(
+        return self._delete(
             f"/v3/memories/{id}",
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
@@ -302,8 +328,12 @@ async def update(
 
     async def list(
         self,
-        id: str,
         *,
+        filters: str | NotGiven = NOT_GIVEN,
+        limit: str | NotGiven = NOT_GIVEN,
+        order: Literal["asc", "desc"] | NotGiven = NOT_GIVEN,
+        page: str | NotGiven = NOT_GIVEN,
+        sort: Literal["createdAt", "updatedAt"] | NotGiven = NOT_GIVEN,
         # 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,
@@ -312,9 +342,19 @@ async def list(
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> MemoryListResponse:
         """
-        Delete a memory
+        Retrieves a paginated list of memories with their metadata and workflow status
 
         Args:
+          filters: Optional filters to apply to the search
+
+          limit: Number of items per page
+
+          order: Sort order
+
+          page: Page number to fetch
+
+          sort: Field to sort by
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -323,12 +363,23 @@ async def list(
 
           timeout: Override the client-level default timeout for this request, in seconds
         """
-        if not id:
-            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
-        return await self._delete(
-            f"/v3/memories/{id}",
+        return await self._get(
+            "/v3/memories",
             options=make_request_options(
-                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                query=await async_maybe_transform(
+                    {
+                        "filters": filters,
+                        "limit": limit,
+                        "order": order,
+                        "page": page,
+                        "sort": sort,
+                    },
+                    memory_list_params.MemoryListParams,
+                ),
             ),
             cast_to=MemoryListResponse,
         )
@@ -345,7 +396,7 @@ async def delete(
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> MemoryDeleteResponse:
         """
-        Get a memory by ID
+        Delete a memory
 
         Args:
           extra_headers: Send extra headers
@@ -358,7 +409,7 @@ async def delete(
         """
         if not id:
             raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
-        return await self._get(
+        return await self._delete(
             f"/v3/memories/{id}",
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout

src/supermemory/types/__init__.py

@@ -3,6 +3,7 @@
 from __future__ import annotations
 
 from .memory_add_params import MemoryAddParams as MemoryAddParams
+from .memory_list_params import MemoryListParams as MemoryListParams
 from .memory_add_response import MemoryAddResponse as MemoryAddResponse
 from .memory_get_response import MemoryGetResponse as MemoryGetResponse
 from .memory_list_response import MemoryListResponse as MemoryListResponse

src/supermemory/types/memory_delete_response.py

@@ -6,6 +6,4 @@
 
 
 class MemoryDeleteResponse(BaseModel):
-    id: str
-
-    status: str
+    success: bool

src/supermemory/types/memory_list_params.py

@@ -0,0 +1,24 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Literal, TypedDict
+
+__all__ = ["MemoryListParams"]
+
+
+class MemoryListParams(TypedDict, total=False):
+    filters: str
+    """Optional filters to apply to the search"""
+
+    limit: str
+    """Number of items per page"""
+
+    order: Literal["asc", "desc"]
+    """Sort order"""
+
+    page: str
+    """Page number to fetch"""
+
+    sort: Literal["createdAt", "updatedAt"]
+    """Field to sort by"""

src/supermemory/types/memory_list_response.py

@@ -1,9 +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__ = ["MemoryListResponse"]
+__all__ = ["MemoryListResponse", "Memory", "Pagination"]
+
+
+class Memory(BaseModel):
+    id: str
+    """Unique identifier 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
+
+    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", "image", "video", "notion_doc", "webpage"]
+    """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.
+    """
+
+    raw: None = None
+    """Raw content of the memory"""
+
+
+class Pagination(BaseModel):
+    current_page: float = FieldInfo(alias="currentPage")
+
+    limit: float
+
+    total_items: float = FieldInfo(alias="totalItems")
+
+    total_pages: float = FieldInfo(alias="totalPages")
 
 
 class MemoryListResponse(BaseModel):
-    success: bool
+    memories: List[Memory]
+
+    pagination: Pagination
+    """Pagination metadata"""