letta-client 1.0.0a8__tar.gz → 1.0.0a9__tar.gz

letta_client-1.0.0a9/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "1.0.0-alpha.9"
+}

{letta_client-1.0.0a8 → letta_client-1.0.0a9}/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## 1.0.0-alpha.9 (2025-10-24)
+
+Full Changelog: [v1.0.0-alpha.8...v1.0.0-alpha.9](https://github.com/letta-ai/letta-python/compare/v1.0.0-alpha.8...v1.0.0-alpha.9)
+
+### Features
+
+* add pagination config for list agent files ([a95c0df](https://github.com/letta-ai/letta-python/commit/a95c0df84af6edc5274a1adf62b528e86bfeda50))
+* add pagination configuration for list batch message endpoint ([d5a8165](https://github.com/letta-ai/letta-python/commit/d5a8165da29148a9579b01bc8ada35eb50160186))
+* make some routes return none for sdk v1 ([2c71c46](https://github.com/letta-ai/letta-python/commit/2c71c468ce408bfe19514dd3d2cb34ca440450b1))
+
+
+### Chores
+
+* add order_by param to list archives [LET-5839] ([bc4b1c8](https://github.com/letta-ai/letta-python/commit/bc4b1c8a6ab51b30f6bdc48995c4cc29921475e6))
+
 ## 1.0.0-alpha.8 (2025-10-24)
 
 Full Changelog: [v1.0.0-alpha.7...v1.0.0-alpha.8](https://github.com/letta-ai/letta-python/compare/v1.0.0-alpha.7...v1.0.0-alpha.8)

{letta_client-1.0.0a8 → letta_client-1.0.0a9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: letta-client
-Version: 1.0.0a8
+Version: 1.0.0a9
 Summary: The official Python library for the letta API
 Project-URL: Homepage, https://github.com/letta-ai/letta-python
 Project-URL: Repository, https://github.com/letta-ai/letta-python

{letta_client-1.0.0a8 → letta_client-1.0.0a9}/api.md

@@ -15,7 +15,7 @@ Methods:
 Types:
 
 ```python
-from letta_client.types import Archive, VectorDBProvider, ArchiveListResponse
+from letta_client.types import Archive, VectorDBProvider
 ```
 
 Methods:
@@ -23,7 +23,7 @@ Methods:
 - <code title="post /v1/archives/">client.archives.<a href="./src/letta_client/resources/archives.py">create</a>(\*\*<a href="src/letta_client/types/archive_create_params.py">params</a>) -> <a href="./src/letta_client/types/archive.py">Archive</a></code>
 - <code title="get /v1/archives/{archive_id}">client.archives.<a href="./src/letta_client/resources/archives.py">retrieve</a>(archive_id) -> <a href="./src/letta_client/types/archive.py">Archive</a></code>
 - <code title="patch /v1/archives/{archive_id}">client.archives.<a href="./src/letta_client/resources/archives.py">update</a>(archive_id, \*\*<a href="src/letta_client/types/archive_update_params.py">params</a>) -> <a href="./src/letta_client/types/archive.py">Archive</a></code>
-- <code title="get /v1/archives/">client.archives.<a href="./src/letta_client/resources/archives.py">list</a>(\*\*<a href="src/letta_client/types/archive_list_params.py">params</a>) -> <a href="./src/letta_client/types/archive_list_response.py">ArchiveListResponse</a></code>
+- <code title="get /v1/archives/">client.archives.<a href="./src/letta_client/resources/archives.py">list</a>(\*\*<a href="src/letta_client/types/archive_list_params.py">params</a>) -> <a href="./src/letta_client/types/archive.py">SyncArrayPage[Archive]</a></code>
 - <code title="delete /v1/archives/{archive_id}">client.archives.<a href="./src/letta_client/resources/archives.py">delete</a>(archive_id) -> <a href="./src/letta_client/types/archive.py">Archive</a></code>
 
 # Tools
@@ -142,9 +142,9 @@ Methods:
 Methods:
 
 - <code title="get /v1/agents/{agent_id}/tools">client.agents.tools.<a href="./src/letta_client/resources/agents/tools.py">list</a>(agent_id, \*\*<a href="src/letta_client/types/agents/tool_list_params.py">params</a>) -> <a href="./src/letta_client/types/tool.py">SyncArrayPage[Tool]</a></code>
-- <code title="patch /v1/agents/{agent_id}/tools/attach/{tool_id}">client.agents.tools.<a href="./src/letta_client/resources/agents/tools.py">attach</a>(tool_id, \*, agent_id) -> <a href="./src/letta_client/types/agent_state.py">AgentState</a></code>
-- <code title="patch /v1/agents/{agent_id}/tools/detach/{tool_id}">client.agents.tools.<a href="./src/letta_client/resources/agents/tools.py">detach</a>(tool_id, \*, agent_id) -> <a href="./src/letta_client/types/agent_state.py">AgentState</a></code>
-- <code title="patch /v1/agents/{agent_id}/tools/approval/{tool_name}">client.agents.tools.<a href="./src/letta_client/resources/agents/tools.py">update_approval</a>(tool_name, \*, agent_id, \*\*<a href="src/letta_client/types/agents/tool_update_approval_params.py">params</a>) -> <a href="./src/letta_client/types/agent_state.py">AgentState</a></code>
+- <code title="patch /v1/agents/{agent_id}/tools/attach/{tool_id}">client.agents.tools.<a href="./src/letta_client/resources/agents/tools.py">attach</a>(tool_id, \*, agent_id) -> <a href="./src/letta_client/types/agent_state.py">Optional[AgentState]</a></code>
+- <code title="patch /v1/agents/{agent_id}/tools/detach/{tool_id}">client.agents.tools.<a href="./src/letta_client/resources/agents/tools.py">detach</a>(tool_id, \*, agent_id) -> <a href="./src/letta_client/types/agent_state.py">Optional[AgentState]</a></code>
+- <code title="patch /v1/agents/{agent_id}/tools/approval/{tool_name}">client.agents.tools.<a href="./src/letta_client/resources/agents/tools.py">update_approval</a>(tool_name, \*, agent_id, \*\*<a href="src/letta_client/types/agents/tool_update_approval_params.py">params</a>) -> <a href="./src/letta_client/types/agent_state.py">Optional[AgentState]</a></code>
 
 ## Folders
 
@@ -170,7 +170,7 @@ from letta_client.types.agents import FileListResponse, FileCloseAllResponse, Fi
 
 Methods:
 
-- <code title="get /v1/agents/{agent_id}/files">client.agents.files.<a href="./src/letta_client/resources/agents/files.py">list</a>(agent_id, \*\*<a href="src/letta_client/types/agents/file_list_params.py">params</a>) -> <a href="./src/letta_client/types/agents/file_list_response.py">FileListResponse</a></code>
+- <code title="get /v1/agents/{agent_id}/files">client.agents.files.<a href="./src/letta_client/resources/agents/files.py">list</a>(agent_id, \*\*<a href="src/letta_client/types/agents/file_list_params.py">params</a>) -> <a href="./src/letta_client/types/agents/file_list_response.py">SyncNextFilesPage[FileListResponse]</a></code>
 - <code title="patch /v1/agents/{agent_id}/files/{file_id}/close">client.agents.files.<a href="./src/letta_client/resources/agents/files.py">close</a>(file_id, \*, agent_id) -> object</code>
 - <code title="patch /v1/agents/{agent_id}/files/close-all">client.agents.files.<a href="./src/letta_client/resources/agents/files.py">close_all</a>(agent_id) -> <a href="./src/letta_client/types/agents/file_close_all_response.py">FileCloseAllResponse</a></code>
 - <code title="patch /v1/agents/{agent_id}/files/{file_id}/open">client.agents.files.<a href="./src/letta_client/resources/agents/files.py">open</a>(file_id, \*, agent_id) -> <a href="./src/letta_client/types/agents/file_open_response.py">FileOpenResponse</a></code>
@@ -501,15 +501,9 @@ Methods:
 
 ## Messages
 
-Types:
-
-```python
-from letta_client.types.batches import MessageListResponse
-```
-
 Methods:
 
-- <code title="get /v1/messages/batches/{batch_id}/messages">client.batches.messages.<a href="./src/letta_client/resources/batches/messages.py">list</a>(batch_id, \*\*<a href="src/letta_client/types/batches/message_list_params.py">params</a>) -> <a href="./src/letta_client/types/batches/message_list_response.py">MessageListResponse</a></code>
+- <code title="get /v1/messages/batches/{batch_id}/messages">client.batches.messages.<a href="./src/letta_client/resources/batches/messages.py">list</a>(batch_id, \*\*<a href="src/letta_client/types/batches/message_list_params.py">params</a>) -> <a href="./src/letta_client/types/agents/message.py">SyncObjectPage[Message]</a></code>
 
 # Templates
 

{letta_client-1.0.0a8 → letta_client-1.0.0a9}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "letta-client"
-version = "1.0.0-alpha.8"
+version = "1.0.0-alpha.9"
 description = "The official Python library for the letta API"
 dynamic = ["readme"]
 license = "Apache-2.0"

{letta_client-1.0.0a8 → letta_client-1.0.0a9}/src/letta_client/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "letta_client"
-__version__ = "1.0.0-alpha.8"  # x-release-please-version
+__version__ = "1.0.0-alpha.9"  # x-release-please-version

letta_client-1.0.0a9/src/letta_client/pagination.py

@@ -0,0 +1,280 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Any, List, Type, Generic, Mapping, TypeVar, Optional, cast
+from typing_extensions import Protocol, override, runtime_checkable
+
+from httpx import Response
+
+from ._utils import is_mapping
+from ._models import BaseModel
+from ._base_client import BasePage, PageInfo, BaseSyncPage, BaseAsyncPage
+
+__all__ = [
+    "SyncArrayPage",
+    "AsyncArrayPage",
+    "SyncObjectPage",
+    "AsyncObjectPage",
+    "SyncNextFilesPage",
+    "AsyncNextFilesPage",
+]
+
+_BaseModelT = TypeVar("_BaseModelT", bound=BaseModel)
+
+_T = TypeVar("_T")
+
+
+@runtime_checkable
+class ArrayPageItem(Protocol):
+    id: Optional[str]
+
+
+@runtime_checkable
+class ObjectPageItem(Protocol):
+    id: Optional[str]
+
+
+@runtime_checkable
+class NextFilesPageItem(Protocol):
+    next_cursor: Optional[str]
+
+
+class SyncArrayPage(BaseSyncPage[_T], BasePage[_T], Generic[_T]):
+    items: List[_T]
+
+    @override
+    def _get_page_items(self) -> List[_T]:
+        items = self.items
+        if not items:
+            return []
+        return items
+
+    @override
+    def next_page_info(self) -> Optional[PageInfo]:
+        is_forwards = not self._options.params.get("before", False)
+
+        items = self.items
+        if not items:
+            return None
+
+        if is_forwards:
+            item = cast(Any, items[-1])
+            if not isinstance(item, ArrayPageItem) or item.id is None:
+                # TODO emit warning log
+                return None
+
+            return PageInfo(params={"after": item.id})
+        else:
+            item = cast(Any, self.items[0])
+            if not isinstance(item, ArrayPageItem) or item.id is None:
+                # TODO emit warning log
+                return None
+
+            return PageInfo(params={"before": item.id})
+
+    @classmethod
+    def build(cls: Type[_BaseModelT], *, response: Response, data: object) -> _BaseModelT:  # noqa: ARG003
+        return cls.construct(
+            None,
+            **{
+                **(cast(Mapping[str, Any], data) if is_mapping(data) else {"items": data}),
+            },
+        )
+
+
+class AsyncArrayPage(BaseAsyncPage[_T], BasePage[_T], Generic[_T]):
+    items: List[_T]
+
+    @override
+    def _get_page_items(self) -> List[_T]:
+        items = self.items
+        if not items:
+            return []
+        return items
+
+    @override
+    def next_page_info(self) -> Optional[PageInfo]:
+        is_forwards = not self._options.params.get("before", False)
+
+        items = self.items
+        if not items:
+            return None
+
+        if is_forwards:
+            item = cast(Any, items[-1])
+            if not isinstance(item, ArrayPageItem) or item.id is None:
+                # TODO emit warning log
+                return None
+
+            return PageInfo(params={"after": item.id})
+        else:
+            item = cast(Any, self.items[0])
+            if not isinstance(item, ArrayPageItem) or item.id is None:
+                # TODO emit warning log
+                return None
+
+            return PageInfo(params={"before": item.id})
+
+    @classmethod
+    def build(cls: Type[_BaseModelT], *, response: Response, data: object) -> _BaseModelT:  # noqa: ARG003
+        return cls.construct(
+            None,
+            **{
+                **(cast(Mapping[str, Any], data) if is_mapping(data) else {"items": data}),
+            },
+        )
+
+
+class SyncObjectPage(BaseSyncPage[_T], BasePage[_T], Generic[_T]):
+    messages: List[_T]
+
+    @override
+    def _get_page_items(self) -> List[_T]:
+        messages = self.messages
+        if not messages:
+            return []
+        return messages
+
+    @override
+    def next_page_info(self) -> Optional[PageInfo]:
+        is_forwards = not self._options.params.get("before", False)
+
+        messages = self.messages
+        if not messages:
+            return None
+
+        if is_forwards:
+            item = cast(Any, messages[-1])
+            if not isinstance(item, ObjectPageItem) or item.id is None:
+                # TODO emit warning log
+                return None
+
+            return PageInfo(params={"after": item.id})
+        else:
+            item = cast(Any, self.messages[0])
+            if not isinstance(item, ObjectPageItem) or item.id is None:
+                # TODO emit warning log
+                return None
+
+            return PageInfo(params={"before": item.id})
+
+
+class AsyncObjectPage(BaseAsyncPage[_T], BasePage[_T], Generic[_T]):
+    messages: List[_T]
+
+    @override
+    def _get_page_items(self) -> List[_T]:
+        messages = self.messages
+        if not messages:
+            return []
+        return messages
+
+    @override
+    def next_page_info(self) -> Optional[PageInfo]:
+        is_forwards = not self._options.params.get("before", False)
+
+        messages = self.messages
+        if not messages:
+            return None
+
+        if is_forwards:
+            item = cast(Any, messages[-1])
+            if not isinstance(item, ObjectPageItem) or item.id is None:
+                # TODO emit warning log
+                return None
+
+            return PageInfo(params={"after": item.id})
+        else:
+            item = cast(Any, self.messages[0])
+            if not isinstance(item, ObjectPageItem) or item.id is None:
+                # TODO emit warning log
+                return None
+
+            return PageInfo(params={"before": item.id})
+
+
+class SyncNextFilesPage(BaseSyncPage[_T], BasePage[_T], Generic[_T]):
+    files: List[_T]
+    next_cursor: Optional[str] = None
+    has_more: Optional[bool] = None
+
+    @override
+    def _get_page_items(self) -> List[_T]:
+        files = self.files
+        if not files:
+            return []
+        return files
+
+    @override
+    def has_next_page(self) -> bool:
+        has_more = self.has_more
+        if has_more is not None and has_more is False:
+            return False
+
+        return super().has_next_page()
+
+    @override
+    def next_page_info(self) -> Optional[PageInfo]:
+        is_forwards = not self._options.params.get("before", False)
+
+        files = self.files
+        if not files:
+            return None
+
+        if is_forwards:
+            item = cast(Any, files[-1])
+            if not isinstance(item, NextFilesPageItem) or item.next_cursor is None:
+                # TODO emit warning log
+                return None
+
+            return PageInfo(params={"after": item.next_cursor})
+        else:
+            item = cast(Any, self.files[0])
+            if not isinstance(item, NextFilesPageItem) or item.next_cursor is None:
+                # TODO emit warning log
+                return None
+
+            return PageInfo(params={"before": item.next_cursor})
+
+
+class AsyncNextFilesPage(BaseAsyncPage[_T], BasePage[_T], Generic[_T]):
+    files: List[_T]
+    next_cursor: Optional[str] = None
+    has_more: Optional[bool] = None
+
+    @override
+    def _get_page_items(self) -> List[_T]:
+        files = self.files
+        if not files:
+            return []
+        return files
+
+    @override
+    def has_next_page(self) -> bool:
+        has_more = self.has_more
+        if has_more is not None and has_more is False:
+            return False
+
+        return super().has_next_page()
+
+    @override
+    def next_page_info(self) -> Optional[PageInfo]:
+        is_forwards = not self._options.params.get("before", False)
+
+        files = self.files
+        if not files:
+            return None
+
+        if is_forwards:
+            item = cast(Any, files[-1])
+            if not isinstance(item, NextFilesPageItem) or item.next_cursor is None:
+                # TODO emit warning log
+                return None
+
+            return PageInfo(params={"after": item.next_cursor})
+        else:
+            item = cast(Any, self.files[0])
+            if not isinstance(item, NextFilesPageItem) or item.next_cursor is None:
+                # TODO emit warning log
+                return None
+
+            return PageInfo(params={"before": item.next_cursor})

{letta_client-1.0.0a8 → letta_client-1.0.0a9}/src/letta_client/resources/agents/files.py

@@ -8,7 +8,7 @@ from typing_extensions import Literal
 import httpx
 
 from ..._types import Body, Omit, Query, Headers, NotGiven, omit, not_given
-from ..._utils import maybe_transform, async_maybe_transform
+from ..._utils import maybe_transform
 from ..._compat import cached_property
 from ..._resource import SyncAPIResource, AsyncAPIResource
 from ..._response import (
@@ -17,7 +17,8 @@ from ..._response import (
     async_to_raw_response_wrapper,
     async_to_streamed_response_wrapper,
 )
-from ..._base_client import make_request_options
+from ...pagination import SyncNextFilesPage, AsyncNextFilesPage
+from ..._base_client import AsyncPaginator, make_request_options
 from ...types.agents import file_list_params
 from ...types.agents.file_list_response import FileListResponse
 from ...types.agents.file_open_response import FileOpenResponse
@@ -63,7 +64,7 @@ class FilesResource(SyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> FileListResponse:
+    ) -> SyncNextFilesPage[FileListResponse]:
         """
         Get the files attached to an agent with their open/closed status.
 
@@ -97,8 +98,9 @@ class FilesResource(SyncAPIResource):
         """
         if not agent_id:
             raise ValueError(f"Expected a non-empty value for `agent_id` but received {agent_id!r}")
-        return self._get(
+        return self._get_api_list(
             f"/v1/agents/{agent_id}/files",
+            page=SyncNextFilesPage[FileListResponse],
             options=make_request_options(
                 extra_headers=extra_headers,
                 extra_query=extra_query,
@@ -117,7 +119,7 @@ class FilesResource(SyncAPIResource):
                     file_list_params.FileListParams,
                 ),
             ),
-            cast_to=FileListResponse,
+            model=FileListResponse,
         )
 
     def close(
@@ -266,7 +268,7 @@ class AsyncFilesResource(AsyncAPIResource):
         """
         return AsyncFilesResourceWithStreamingResponse(self)
 
-    async def list(
+    def list(
         self,
         agent_id: str,
         *,
@@ -283,7 +285,7 @@ class AsyncFilesResource(AsyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> FileListResponse:
+    ) -> AsyncPaginator[FileListResponse, AsyncNextFilesPage[FileListResponse]]:
         """
         Get the files attached to an agent with their open/closed status.
 
@@ -317,14 +319,15 @@ class AsyncFilesResource(AsyncAPIResource):
         """
         if not agent_id:
             raise ValueError(f"Expected a non-empty value for `agent_id` but received {agent_id!r}")
-        return await self._get(
+        return self._get_api_list(
             f"/v1/agents/{agent_id}/files",
+            page=AsyncNextFilesPage[FileListResponse],
             options=make_request_options(
                 extra_headers=extra_headers,
                 extra_query=extra_query,
                 extra_body=extra_body,
                 timeout=timeout,
-                query=await async_maybe_transform(
+                query=maybe_transform(
                     {
                         "after": after,
                         "before": before,
@@ -337,7 +340,7 @@ class AsyncFilesResource(AsyncAPIResource):
                     file_list_params.FileListParams,
                 ),
             ),
-            cast_to=FileListResponse,
+            model=FileListResponse,
         )
 
     async def close(

{letta_client-1.0.0a8 → letta_client-1.0.0a9}/src/letta_client/resources/agents/tools.py

@@ -124,7 +124,7 @@ class ToolsResource(SyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> AgentState:
+    ) -> Optional[AgentState]:
         """
         Attach a tool to an agent.
 
@@ -164,7 +164,7 @@ class ToolsResource(SyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> AgentState:
+    ) -> Optional[AgentState]:
         """
         Detach a tool from an agent.
 
@@ -206,7 +206,7 @@ class ToolsResource(SyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> AgentState:
+    ) -> Optional[AgentState]:
         """
         Modify the approval requirement for a tool attached to an agent.
 
@@ -349,7 +349,7 @@ class AsyncToolsResource(AsyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> AgentState:
+    ) -> Optional[AgentState]:
         """
         Attach a tool to an agent.
 
@@ -389,7 +389,7 @@ class AsyncToolsResource(AsyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> AgentState:
+    ) -> Optional[AgentState]:
         """
         Detach a tool from an agent.
 
@@ -431,7 +431,7 @@ class AsyncToolsResource(AsyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> AgentState:
+    ) -> Optional[AgentState]:
         """
         Modify the approval requirement for a tool attached to an agent.
 

{letta_client-1.0.0a8 → letta_client-1.0.0a9}/src/letta_client/resources/archives.py

@@ -18,9 +18,9 @@ from .._response import (
     async_to_raw_response_wrapper,
     async_to_streamed_response_wrapper,
 )
-from .._base_client import make_request_options
+from ..pagination import SyncArrayPage, AsyncArrayPage
+from .._base_client import AsyncPaginator, make_request_options
 from ..types.archive import Archive
-from ..types.archive_list_response import ArchiveListResponse
 from ..types.embedding_config_param import EmbeddingConfigParam
 
 __all__ = ["ArchivesResource", "AsyncArchivesResource"]
@@ -177,13 +177,14 @@ class ArchivesResource(SyncAPIResource):
         limit: Optional[int] | Omit = omit,
         name: Optional[str] | Omit = omit,
         order: Literal["asc", "desc"] | Omit = omit,
+        order_by: Literal["created_at"] | Omit = omit,
         # 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,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> ArchiveListResponse:
+    ) -> SyncArrayPage[Archive]:
         """
         Get a list of all archives for the current organization with optional filters
         and pagination.
@@ -204,6 +205,8 @@ class ArchivesResource(SyncAPIResource):
           order: Sort order for archives by creation time. 'asc' for oldest first, 'desc' for
               newest first
 
+          order_by: Field to sort by
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -212,8 +215,9 @@ class ArchivesResource(SyncAPIResource):
 
           timeout: Override the client-level default timeout for this request, in seconds
         """
-        return self._get(
+        return self._get_api_list(
             "/v1/archives/",
+            page=SyncArrayPage[Archive],
             options=make_request_options(
                 extra_headers=extra_headers,
                 extra_query=extra_query,
@@ -227,11 +231,12 @@ class ArchivesResource(SyncAPIResource):
                         "limit": limit,
                         "name": name,
                         "order": order,
+                        "order_by": order_by,
                     },
                     archive_list_params.ArchiveListParams,
                 ),
             ),
-            cast_to=ArchiveListResponse,
+            model=Archive,
         )
 
     def delete(
@@ -412,7 +417,7 @@ class AsyncArchivesResource(AsyncAPIResource):
             cast_to=Archive,
         )
 
-    async def list(
+    def list(
         self,
         *,
         after: Optional[str] | Omit = omit,
@@ -421,13 +426,14 @@ class AsyncArchivesResource(AsyncAPIResource):
         limit: Optional[int] | Omit = omit,
         name: Optional[str] | Omit = omit,
         order: Literal["asc", "desc"] | Omit = omit,
+        order_by: Literal["created_at"] | Omit = omit,
         # 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,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> ArchiveListResponse:
+    ) -> AsyncPaginator[Archive, AsyncArrayPage[Archive]]:
         """
         Get a list of all archives for the current organization with optional filters
         and pagination.
@@ -448,6 +454,8 @@ class AsyncArchivesResource(AsyncAPIResource):
           order: Sort order for archives by creation time. 'asc' for oldest first, 'desc' for
               newest first
 
+          order_by: Field to sort by
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -456,14 +464,15 @@ class AsyncArchivesResource(AsyncAPIResource):
 
           timeout: Override the client-level default timeout for this request, in seconds
         """
-        return await self._get(
+        return self._get_api_list(
             "/v1/archives/",
+            page=AsyncArrayPage[Archive],
             options=make_request_options(
                 extra_headers=extra_headers,
                 extra_query=extra_query,
                 extra_body=extra_body,
                 timeout=timeout,
-                query=await async_maybe_transform(
+                query=maybe_transform(
                     {
                         "after": after,
                         "agent_id": agent_id,
@@ -471,11 +480,12 @@ class AsyncArchivesResource(AsyncAPIResource):
                         "limit": limit,
                         "name": name,
                         "order": order,
+                        "order_by": order_by,
                     },
                     archive_list_params.ArchiveListParams,
                 ),
             ),
-            cast_to=ArchiveListResponse,
+            model=Archive,
         )
 
     async def delete(