letta-client 1.0.0a1__py3-none-any.whl → 1.0.0a2__py3-none-any.whl

letta_client/agents/blocks/client.py

@@ -7,6 +7,7 @@ from ...core.request_options import RequestOptions
 from ...types.agent_state import AgentState
 from ...types.block import Block
 from .raw_client import AsyncRawBlocksClient, RawBlocksClient
+from .types.blocks_list_request_order import BlocksListRequestOrder
 
 # this is used as the default value for optional parameters
 OMIT = typing.cast(typing.Any, ...)
@@ -177,7 +178,17 @@ class BlocksClient:
         )
         return _response.data
 
-    def list(self, agent_id: str, *, request_options: typing.Optional[RequestOptions] = None) -> typing.List[Block]:
+    def list(
+        self,
+        agent_id: str,
+        *,
+        before: typing.Optional[str] = None,
+        after: typing.Optional[str] = None,
+        limit: typing.Optional[int] = None,
+        order: typing.Optional[BlocksListRequestOrder] = None,
+        order_by: typing.Optional[typing.Literal["created_at"]] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> typing.List[Block]:
         """
         Retrieve the core memory blocks of a specific agent.
 
@@ -185,6 +196,21 @@ class BlocksClient:
         ----------
         agent_id : str
 
+        before : typing.Optional[str]
+            Block ID cursor for pagination. Returns blocks that come before this block ID in the specified sort order
+
+        after : typing.Optional[str]
+            Block ID cursor for pagination. Returns blocks that come after this block ID in the specified sort order
+
+        limit : typing.Optional[int]
+            Maximum number of blocks to return
+
+        order : typing.Optional[BlocksListRequestOrder]
+            Sort order for blocks by creation time. 'asc' for oldest first, 'desc' for newest first
+
+        order_by : typing.Optional[typing.Literal["created_at"]]
+            Field to sort by
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -203,9 +229,21 @@ class BlocksClient:
         )
         client.agents.blocks.list(
             agent_id="agent_id",
+            before="before",
+            after="after",
+            limit=1,
+            order="asc",
         )
         """
-        _response = self._raw_client.list(agent_id, request_options=request_options)
+        _response = self._raw_client.list(
+            agent_id,
+            before=before,
+            after=after,
+            limit=limit,
+            order=order,
+            order_by=order_by,
+            request_options=request_options,
+        )
         return _response.data
 
     def attach(
@@ -463,7 +501,15 @@ class AsyncBlocksClient:
         return _response.data
 
     async def list(
-        self, agent_id: str, *, request_options: typing.Optional[RequestOptions] = None
+        self,
+        agent_id: str,
+        *,
+        before: typing.Optional[str] = None,
+        after: typing.Optional[str] = None,
+        limit: typing.Optional[int] = None,
+        order: typing.Optional[BlocksListRequestOrder] = None,
+        order_by: typing.Optional[typing.Literal["created_at"]] = None,
+        request_options: typing.Optional[RequestOptions] = None,
     ) -> typing.List[Block]:
         """
         Retrieve the core memory blocks of a specific agent.
@@ -472,6 +518,21 @@ class AsyncBlocksClient:
         ----------
         agent_id : str
 
+        before : typing.Optional[str]
+            Block ID cursor for pagination. Returns blocks that come before this block ID in the specified sort order
+
+        after : typing.Optional[str]
+            Block ID cursor for pagination. Returns blocks that come after this block ID in the specified sort order
+
+        limit : typing.Optional[int]
+            Maximum number of blocks to return
+
+        order : typing.Optional[BlocksListRequestOrder]
+            Sort order for blocks by creation time. 'asc' for oldest first, 'desc' for newest first
+
+        order_by : typing.Optional[typing.Literal["created_at"]]
+            Field to sort by
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -495,12 +556,24 @@ class AsyncBlocksClient:
         async def main() -> None:
             await client.agents.blocks.list(
                 agent_id="agent_id",
+                before="before",
+                after="after",
+                limit=1,
+                order="asc",
             )
 
 
         asyncio.run(main())
         """
-        _response = await self._raw_client.list(agent_id, request_options=request_options)
+        _response = await self._raw_client.list(
+            agent_id,
+            before=before,
+            after=after,
+            limit=limit,
+            order=order,
+            order_by=order_by,
+            request_options=request_options,
+        )
         return _response.data
 
     async def attach(

letta_client/agents/blocks/raw_client.py

@@ -13,6 +13,7 @@ from ...errors.unprocessable_entity_error import UnprocessableEntityError
 from ...types.agent_state import AgentState
 from ...types.block import Block
 from ...types.http_validation_error import HttpValidationError
+from .types.blocks_list_request_order import BlocksListRequestOrder
 
 # this is used as the default value for optional parameters
 OMIT = typing.cast(typing.Any, ...)
@@ -205,7 +206,15 @@ class RawBlocksClient:
         raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
 
     def list(
-        self, agent_id: str, *, request_options: typing.Optional[RequestOptions] = None
+        self,
+        agent_id: str,
+        *,
+        before: typing.Optional[str] = None,
+        after: typing.Optional[str] = None,
+        limit: typing.Optional[int] = None,
+        order: typing.Optional[BlocksListRequestOrder] = None,
+        order_by: typing.Optional[typing.Literal["created_at"]] = None,
+        request_options: typing.Optional[RequestOptions] = None,
     ) -> HttpResponse[typing.List[Block]]:
         """
         Retrieve the core memory blocks of a specific agent.
@@ -214,6 +223,21 @@ class RawBlocksClient:
         ----------
         agent_id : str
 
+        before : typing.Optional[str]
+            Block ID cursor for pagination. Returns blocks that come before this block ID in the specified sort order
+
+        after : typing.Optional[str]
+            Block ID cursor for pagination. Returns blocks that come after this block ID in the specified sort order
+
+        limit : typing.Optional[int]
+            Maximum number of blocks to return
+
+        order : typing.Optional[BlocksListRequestOrder]
+            Sort order for blocks by creation time. 'asc' for oldest first, 'desc' for newest first
+
+        order_by : typing.Optional[typing.Literal["created_at"]]
+            Field to sort by
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -225,6 +249,13 @@ class RawBlocksClient:
         _response = self._client_wrapper.httpx_client.request(
             f"v1/agents/{jsonable_encoder(agent_id)}/core-memory/blocks",
             method="GET",
+            params={
+                "before": before,
+                "after": after,
+                "limit": limit,
+                "order": order,
+                "order_by": order_by,
+            },
             request_options=request_options,
         )
         try:
@@ -543,7 +574,15 @@ class AsyncRawBlocksClient:
         raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
 
     async def list(
-        self, agent_id: str, *, request_options: typing.Optional[RequestOptions] = None
+        self,
+        agent_id: str,
+        *,
+        before: typing.Optional[str] = None,
+        after: typing.Optional[str] = None,
+        limit: typing.Optional[int] = None,
+        order: typing.Optional[BlocksListRequestOrder] = None,
+        order_by: typing.Optional[typing.Literal["created_at"]] = None,
+        request_options: typing.Optional[RequestOptions] = None,
     ) -> AsyncHttpResponse[typing.List[Block]]:
         """
         Retrieve the core memory blocks of a specific agent.
@@ -552,6 +591,21 @@ class AsyncRawBlocksClient:
         ----------
         agent_id : str
 
+        before : typing.Optional[str]
+            Block ID cursor for pagination. Returns blocks that come before this block ID in the specified sort order
+
+        after : typing.Optional[str]
+            Block ID cursor for pagination. Returns blocks that come after this block ID in the specified sort order
+
+        limit : typing.Optional[int]
+            Maximum number of blocks to return
+
+        order : typing.Optional[BlocksListRequestOrder]
+            Sort order for blocks by creation time. 'asc' for oldest first, 'desc' for newest first
+
+        order_by : typing.Optional[typing.Literal["created_at"]]
+            Field to sort by
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -563,6 +617,13 @@ class AsyncRawBlocksClient:
         _response = await self._client_wrapper.httpx_client.request(
             f"v1/agents/{jsonable_encoder(agent_id)}/core-memory/blocks",
             method="GET",
+            params={
+                "before": before,
+                "after": after,
+                "limit": limit,
+                "order": order,
+                "order_by": order_by,
+            },
             request_options=request_options,
         )
         try:

letta_client/agents/blocks/types/__init__.py

@@ -0,0 +1,7 @@
+# This file was auto-generated by Fern from our API Definition.
+
+# isort: skip_file
+
+from .blocks_list_request_order import BlocksListRequestOrder
+
+__all__ = ["BlocksListRequestOrder"]

letta_client/agents/blocks/types/blocks_list_request_order.py

@@ -0,0 +1,5 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+BlocksListRequestOrder = typing.Union[typing.Literal["asc", "desc"], typing.Any]

letta_client/agents/client.py

@@ -24,7 +24,6 @@ from .messages.client import AsyncMessagesClient, MessagesClient
 from .passages.client import AsyncPassagesClient, PassagesClient
 from .raw_client import AsyncRawAgentsClient, RawAgentsClient
 from .sources.client import AsyncSourcesClient, SourcesClient
-from .templates.client import AsyncTemplatesClient, TemplatesClient
 from .tools.client import AsyncToolsClient, ToolsClient
 from .types.agents_list_request_order import AgentsListRequestOrder
 from .types.agents_list_request_order_by import AgentsListRequestOrderBy
@@ -63,8 +62,6 @@ class AgentsClient:
 
         self.groups = GroupsClient(client_wrapper=client_wrapper)
 
-        self.templates = TemplatesClient(client_wrapper=client_wrapper)
-
         self.memory_variables = MemoryVariablesClient(client_wrapper=client_wrapper)
 
     @property
@@ -172,7 +169,22 @@ class AgentsClient:
             project="YOUR_PROJECT",
             token="YOUR_TOKEN",
         )
-        client.agents.list()
+        client.agents.list(
+            name="name",
+            match_all_tags=True,
+            before="before",
+            after="after",
+            limit=1,
+            query_text="query_text",
+            project_id="project_id",
+            template_id="template_id",
+            base_template_id="base_template_id",
+            identity_id="identity_id",
+            order="asc",
+            order_by="created_at",
+            ascending=True,
+            sort_by="sort_by",
+        )
         """
         _response = self._raw_client.list(
             name=name,
@@ -332,10 +344,10 @@ class AgentsClient:
             Whether to enable reasoning for this agent.
 
         from_template : typing.Optional[str]
-            The template id used to configure the agent
+            Deprecated: please use the 'create agents from a template' endpoint instead.
 
         template : typing.Optional[bool]
-            Whether the agent is a template
+            Deprecated: No longer used
 
         project : typing.Optional[str]
             Deprecated: Project should now be passed via the X-Project header instead of in the request body. If using the sdk, this can be done via the new x_project field below.
@@ -518,6 +530,8 @@ class AgentsClient:
         )
         client.agents.export_file(
             agent_id="agent_id",
+            max_steps=1,
+            use_legacy_format=True,
         )
         """
         _response = self._raw_client.export_file(
@@ -583,7 +597,9 @@ class AgentsClient:
             project="YOUR_PROJECT",
             token="YOUR_TOKEN",
         )
-        client.agents.import_file()
+        client.agents.import_file(
+            override_embedding_model="x-override-embedding-model",
+        )
         """
         _response = self._raw_client.import_file(
             file=file,
@@ -949,8 +965,6 @@ class AsyncAgentsClient:
 
         self.groups = AsyncGroupsClient(client_wrapper=client_wrapper)
 
-        self.templates = AsyncTemplatesClient(client_wrapper=client_wrapper)
-
         self.memory_variables = AsyncMemoryVariablesClient(client_wrapper=client_wrapper)
 
     @property
@@ -1063,7 +1077,22 @@ class AsyncAgentsClient:
 
 
         async def main() -> None:
-            await client.agents.list()
+            await client.agents.list(
+                name="name",
+                match_all_tags=True,
+                before="before",
+                after="after",
+                limit=1,
+                query_text="query_text",
+                project_id="project_id",
+                template_id="template_id",
+                base_template_id="base_template_id",
+                identity_id="identity_id",
+                order="asc",
+                order_by="created_at",
+                ascending=True,
+                sort_by="sort_by",
+            )
 
 
         asyncio.run(main())
@@ -1226,10 +1255,10 @@ class AsyncAgentsClient:
             Whether to enable reasoning for this agent.
 
         from_template : typing.Optional[str]
-            The template id used to configure the agent
+            Deprecated: please use the 'create agents from a template' endpoint instead.
 
         template : typing.Optional[bool]
-            Whether the agent is a template
+            Deprecated: No longer used
 
         project : typing.Optional[str]
             Deprecated: Project should now be passed via the X-Project header instead of in the request body. If using the sdk, this can be done via the new x_project field below.
@@ -1433,6 +1462,8 @@ class AsyncAgentsClient:
         async def main() -> None:
             await client.agents.export_file(
                 agent_id="agent_id",
+                max_steps=1,
+                use_legacy_format=True,
             )
 
 
@@ -1506,7 +1537,9 @@ class AsyncAgentsClient:
 
 
         async def main() -> None:
-            await client.agents.import_file()
+            await client.agents.import_file(
+                override_embedding_model="x-override-embedding-model",
+            )
 
 
         asyncio.run(main())

letta_client/agents/files/__init__.py

@@ -2,3 +2,6 @@
 
 # isort: skip_file
 
+from .types import FilesListRequestOrder
+
+__all__ = ["FilesListRequestOrder"]

letta_client/agents/files/client.py

@@ -6,6 +6,7 @@ from ...core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
 from ...core.request_options import RequestOptions
 from ...types.paginated_agent_files import PaginatedAgentFiles
 from .raw_client import AsyncRawFilesClient, RawFilesClient
+from .types.files_list_request_order import FilesListRequestOrder
 
 
 class FilesClient:
@@ -140,8 +141,12 @@ class FilesClient:
         self,
         agent_id: str,
         *,
-        cursor: typing.Optional[str] = None,
+        before: typing.Optional[str] = None,
+        after: typing.Optional[str] = None,
         limit: typing.Optional[int] = None,
+        order: typing.Optional[FilesListRequestOrder] = None,
+        order_by: typing.Optional[typing.Literal["created_at"]] = None,
+        cursor: typing.Optional[str] = None,
         is_open: typing.Optional[bool] = None,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> PaginatedAgentFiles:
@@ -152,11 +157,23 @@ class FilesClient:
         ----------
         agent_id : str
 
-        cursor : typing.Optional[str]
-            Pagination cursor from previous response
+        before : typing.Optional[str]
+            File ID cursor for pagination. Returns files that come before this file ID in the specified sort order
+
+        after : typing.Optional[str]
+            File ID cursor for pagination. Returns files that come after this file ID in the specified sort order
 
         limit : typing.Optional[int]
-            Number of items to return (1-100)
+            Maximum number of files to return
+
+        order : typing.Optional[FilesListRequestOrder]
+            Sort order for files by creation time. 'asc' for oldest first, 'desc' for newest first
+
+        order_by : typing.Optional[typing.Literal["created_at"]]
+            Field to sort by
+
+        cursor : typing.Optional[str]
+            Pagination cursor from previous response (deprecated, use before/after)
 
         is_open : typing.Optional[bool]
             Filter by open status (true for open files, false for closed files)
@@ -179,10 +196,24 @@ class FilesClient:
         )
         client.agents.files.list(
             agent_id="agent_id",
+            before="before",
+            after="after",
+            limit=1,
+            order="asc",
+            cursor="cursor",
+            is_open=True,
         )
         """
         _response = self._raw_client.list(
-            agent_id, cursor=cursor, limit=limit, is_open=is_open, request_options=request_options
+            agent_id,
+            before=before,
+            after=after,
+            limit=limit,
+            order=order,
+            order_by=order_by,
+            cursor=cursor,
+            is_open=is_open,
+            request_options=request_options,
         )
         return _response.data
 
@@ -345,8 +376,12 @@ class AsyncFilesClient:
         self,
         agent_id: str,
         *,
-        cursor: typing.Optional[str] = None,
+        before: typing.Optional[str] = None,
+        after: typing.Optional[str] = None,
         limit: typing.Optional[int] = None,
+        order: typing.Optional[FilesListRequestOrder] = None,
+        order_by: typing.Optional[typing.Literal["created_at"]] = None,
+        cursor: typing.Optional[str] = None,
         is_open: typing.Optional[bool] = None,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> PaginatedAgentFiles:
@@ -357,11 +392,23 @@ class AsyncFilesClient:
         ----------
         agent_id : str
 
-        cursor : typing.Optional[str]
-            Pagination cursor from previous response
+        before : typing.Optional[str]
+            File ID cursor for pagination. Returns files that come before this file ID in the specified sort order
+
+        after : typing.Optional[str]
+            File ID cursor for pagination. Returns files that come after this file ID in the specified sort order
 
         limit : typing.Optional[int]
-            Number of items to return (1-100)
+            Maximum number of files to return
+
+        order : typing.Optional[FilesListRequestOrder]
+            Sort order for files by creation time. 'asc' for oldest first, 'desc' for newest first
+
+        order_by : typing.Optional[typing.Literal["created_at"]]
+            Field to sort by
+
+        cursor : typing.Optional[str]
+            Pagination cursor from previous response (deprecated, use before/after)
 
         is_open : typing.Optional[bool]
             Filter by open status (true for open files, false for closed files)
@@ -389,12 +436,26 @@ class AsyncFilesClient:
         async def main() -> None:
             await client.agents.files.list(
                 agent_id="agent_id",
+                before="before",
+                after="after",
+                limit=1,
+                order="asc",
+                cursor="cursor",
+                is_open=True,
             )
 
 
         asyncio.run(main())
         """
         _response = await self._raw_client.list(
-            agent_id, cursor=cursor, limit=limit, is_open=is_open, request_options=request_options
+            agent_id,
+            before=before,
+            after=after,
+            limit=limit,
+            order=order,
+            order_by=order_by,
+            cursor=cursor,
+            is_open=is_open,
+            request_options=request_options,
         )
         return _response.data

letta_client/agents/files/raw_client.py

@@ -12,6 +12,7 @@ from ...core.unchecked_base_model import construct_type
 from ...errors.unprocessable_entity_error import UnprocessableEntityError
 from ...types.http_validation_error import HttpValidationError
 from ...types.paginated_agent_files import PaginatedAgentFiles
+from .types.files_list_request_order import FilesListRequestOrder
 
 
 class RawFilesClient:
@@ -185,8 +186,12 @@ class RawFilesClient:
         self,
         agent_id: str,
         *,
-        cursor: typing.Optional[str] = None,
+        before: typing.Optional[str] = None,
+        after: typing.Optional[str] = None,
         limit: typing.Optional[int] = None,
+        order: typing.Optional[FilesListRequestOrder] = None,
+        order_by: typing.Optional[typing.Literal["created_at"]] = None,
+        cursor: typing.Optional[str] = None,
         is_open: typing.Optional[bool] = None,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> HttpResponse[PaginatedAgentFiles]:
@@ -197,11 +202,23 @@ class RawFilesClient:
         ----------
         agent_id : str
 
-        cursor : typing.Optional[str]
-            Pagination cursor from previous response
+        before : typing.Optional[str]
+            File ID cursor for pagination. Returns files that come before this file ID in the specified sort order
+
+        after : typing.Optional[str]
+            File ID cursor for pagination. Returns files that come after this file ID in the specified sort order
 
         limit : typing.Optional[int]
-            Number of items to return (1-100)
+            Maximum number of files to return
+
+        order : typing.Optional[FilesListRequestOrder]
+            Sort order for files by creation time. 'asc' for oldest first, 'desc' for newest first
+
+        order_by : typing.Optional[typing.Literal["created_at"]]
+            Field to sort by
+
+        cursor : typing.Optional[str]
+            Pagination cursor from previous response (deprecated, use before/after)
 
         is_open : typing.Optional[bool]
             Filter by open status (true for open files, false for closed files)
@@ -218,8 +235,12 @@ class RawFilesClient:
             f"v1/agents/{jsonable_encoder(agent_id)}/files",
             method="GET",
             params={
-                "cursor": cursor,
+                "before": before,
+                "after": after,
                 "limit": limit,
+                "order": order,
+                "order_by": order_by,
+                "cursor": cursor,
                 "is_open": is_open,
             },
             request_options=request_options,
@@ -422,8 +443,12 @@ class AsyncRawFilesClient:
         self,
         agent_id: str,
         *,
-        cursor: typing.Optional[str] = None,
+        before: typing.Optional[str] = None,
+        after: typing.Optional[str] = None,
         limit: typing.Optional[int] = None,
+        order: typing.Optional[FilesListRequestOrder] = None,
+        order_by: typing.Optional[typing.Literal["created_at"]] = None,
+        cursor: typing.Optional[str] = None,
         is_open: typing.Optional[bool] = None,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> AsyncHttpResponse[PaginatedAgentFiles]:
@@ -434,11 +459,23 @@ class AsyncRawFilesClient:
         ----------
         agent_id : str
 
-        cursor : typing.Optional[str]
-            Pagination cursor from previous response
+        before : typing.Optional[str]
+            File ID cursor for pagination. Returns files that come before this file ID in the specified sort order
+
+        after : typing.Optional[str]
+            File ID cursor for pagination. Returns files that come after this file ID in the specified sort order
 
         limit : typing.Optional[int]
-            Number of items to return (1-100)
+            Maximum number of files to return
+
+        order : typing.Optional[FilesListRequestOrder]
+            Sort order for files by creation time. 'asc' for oldest first, 'desc' for newest first
+
+        order_by : typing.Optional[typing.Literal["created_at"]]
+            Field to sort by
+
+        cursor : typing.Optional[str]
+            Pagination cursor from previous response (deprecated, use before/after)
 
         is_open : typing.Optional[bool]
             Filter by open status (true for open files, false for closed files)
@@ -455,8 +492,12 @@ class AsyncRawFilesClient:
             f"v1/agents/{jsonable_encoder(agent_id)}/files",
             method="GET",
             params={
-                "cursor": cursor,
+                "before": before,
+                "after": after,
                 "limit": limit,
+                "order": order,
+                "order_by": order_by,
+                "cursor": cursor,
                 "is_open": is_open,
             },
             request_options=request_options,

letta_client/agents/files/types/__init__.py

@@ -0,0 +1,7 @@
+# This file was auto-generated by Fern from our API Definition.
+
+# isort: skip_file
+
+from .files_list_request_order import FilesListRequestOrder
+
+__all__ = ["FilesListRequestOrder"]

letta_client/{types/tool_return_status.py → agents/files/types/files_list_request_order.py}

@@ -2,4 +2,4 @@
 
 import typing
 
-ToolReturnStatus = typing.Union[typing.Literal["success", "error"], typing.Any]
+FilesListRequestOrder = typing.Union[typing.Literal["asc", "desc"], typing.Any]