letta-client 1.0.0a7__py3-none-any.whl → 1.0.0a9__py3-none-any.whl

letta_client/resources/steps/steps.py

@@ -25,7 +25,7 @@ from .metrics import (
     AsyncMetricsResourceWithStreamingResponse,
 )
 from ..._types import Body, Omit, Query, Headers, NotGiven, SequenceNotStr, omit, not_given
-from ..._utils import maybe_transform, strip_not_given, async_maybe_transform
+from ..._utils import maybe_transform, strip_not_given
 from .feedback import (
     FeedbackResource,
     AsyncFeedbackResource,
@@ -50,9 +50,9 @@ from ..._response import (
     async_to_raw_response_wrapper,
     async_to_streamed_response_wrapper,
 )
+from ...pagination import SyncArrayPage, AsyncArrayPage
 from ...types.step import Step
-from ..._base_client import make_request_options
-from ...types.step_list_response import StepListResponse
+from ..._base_client import AsyncPaginator, make_request_options
 
 __all__ = ["StepsResource", "AsyncStepsResource"]
 
@@ -152,7 +152,7 @@ class StepsResource(SyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> StepListResponse:
+    ) -> SyncArrayPage[Step]:
         """
         List steps with optional pagination and date filters.
 
@@ -197,8 +197,9 @@ class StepsResource(SyncAPIResource):
           timeout: Override the client-level default timeout for this request, in seconds
         """
         extra_headers = {**strip_not_given({"X-Project": x_project}), **(extra_headers or {})}
-        return self._get(
+        return self._get_api_list(
             "/v1/steps/",
+            page=SyncArrayPage[Step],
             options=make_request_options(
                 extra_headers=extra_headers,
                 extra_query=extra_query,
@@ -224,7 +225,7 @@ class StepsResource(SyncAPIResource):
                     step_list_params.StepListParams,
                 ),
             ),
-            cast_to=StepListResponse,
+            model=Step,
         )
 
 
@@ -299,7 +300,7 @@ class AsyncStepsResource(AsyncAPIResource):
             cast_to=Step,
         )
 
-    async def list(
+    def list(
         self,
         *,
         after: Optional[str] | Omit = omit,
@@ -323,7 +324,7 @@ class AsyncStepsResource(AsyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> StepListResponse:
+    ) -> AsyncPaginator[Step, AsyncArrayPage[Step]]:
         """
         List steps with optional pagination and date filters.
 
@@ -368,14 +369,15 @@ class AsyncStepsResource(AsyncAPIResource):
           timeout: Override the client-level default timeout for this request, in seconds
         """
         extra_headers = {**strip_not_given({"X-Project": x_project}), **(extra_headers or {})}
-        return await self._get(
+        return self._get_api_list(
             "/v1/steps/",
+            page=AsyncArrayPage[Step],
             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,
@@ -395,7 +397,7 @@ class AsyncStepsResource(AsyncAPIResource):
                     step_list_params.StepListParams,
                 ),
             ),
-            cast_to=StepListResponse,
+            model=Step,
         )
 
 

letta_client/resources/tags.py

@@ -9,7 +9,7 @@ import httpx
 
 from ..types import tag_list_params
 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 (
@@ -18,7 +18,8 @@ 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.tag_list_response import TagListResponse
 
 __all__ = ["TagsResource", "AsyncTagsResource"]
@@ -60,7 +61,7 @@ class TagsResource(SyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> TagListResponse:
+    ) -> SyncArrayPage[TagListResponse]:
         """
         Get the list of all agent tags that have been created.
 
@@ -90,8 +91,9 @@ class TagsResource(SyncAPIResource):
 
           timeout: Override the client-level default timeout for this request, in seconds
         """
-        return self._get(
+        return self._get_api_list(
             "/v1/tags/",
+            page=SyncArrayPage[TagListResponse],
             options=make_request_options(
                 extra_headers=extra_headers,
                 extra_query=extra_query,
@@ -110,7 +112,7 @@ class TagsResource(SyncAPIResource):
                     tag_list_params.TagListParams,
                 ),
             ),
-            cast_to=TagListResponse,
+            model=str,
         )
 
 
@@ -134,7 +136,7 @@ class AsyncTagsResource(AsyncAPIResource):
         """
         return AsyncTagsResourceWithStreamingResponse(self)
 
-    async def list(
+    def list(
         self,
         *,
         after: Optional[str] | Omit = omit,
@@ -150,7 +152,7 @@ class AsyncTagsResource(AsyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> TagListResponse:
+    ) -> AsyncPaginator[TagListResponse, AsyncArrayPage[TagListResponse]]:
         """
         Get the list of all agent tags that have been created.
 
@@ -180,14 +182,15 @@ class AsyncTagsResource(AsyncAPIResource):
 
           timeout: Override the client-level default timeout for this request, in seconds
         """
-        return await self._get(
+        return self._get_api_list(
             "/v1/tags/",
+            page=AsyncArrayPage[TagListResponse],
             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,
@@ -200,7 +203,7 @@ class AsyncTagsResource(AsyncAPIResource):
                     tag_list_params.TagListParams,
                 ),
             ),
-            cast_to=TagListResponse,
+            model=str,
         )
 
 

letta_client/resources/tools.py

@@ -18,9 +18,9 @@ from .._response import (
     async_to_raw_response_wrapper,
     async_to_streamed_response_wrapper,
 )
+from ..pagination import SyncArrayPage, AsyncArrayPage
 from ..types.tool import Tool
-from .._base_client import make_request_options
-from ..types.tool_list_response import ToolListResponse
+from .._base_client import AsyncPaginator, make_request_options
 from ..types.tool_count_response import ToolCountResponse
 from ..types.npm_requirement_param import NpmRequirementParam
 from ..types.pip_requirement_param import PipRequirementParam
@@ -276,7 +276,7 @@ class ToolsResource(SyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> ToolListResponse:
+    ) -> SyncArrayPage[Tool]:
         """
         Get a list of all tools available to agents.
 
@@ -316,8 +316,9 @@ class ToolsResource(SyncAPIResource):
 
           timeout: Override the client-level default timeout for this request, in seconds
         """
-        return self._get(
+        return self._get_api_list(
             "/v1/tools/",
+            page=SyncArrayPage[Tool],
             options=make_request_options(
                 extra_headers=extra_headers,
                 extra_query=extra_query,
@@ -341,7 +342,7 @@ class ToolsResource(SyncAPIResource):
                     tool_list_params.ToolListParams,
                 ),
             ),
-            cast_to=ToolListResponse,
+            model=Tool,
         )
 
     def delete(
@@ -774,7 +775,7 @@ class AsyncToolsResource(AsyncAPIResource):
             cast_to=Tool,
         )
 
-    async def list(
+    def list(
         self,
         *,
         after: Optional[str] | Omit = omit,
@@ -795,7 +796,7 @@ class AsyncToolsResource(AsyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> ToolListResponse:
+    ) -> AsyncPaginator[Tool, AsyncArrayPage[Tool]]:
         """
         Get a list of all tools available to agents.
 
@@ -835,14 +836,15 @@ class AsyncToolsResource(AsyncAPIResource):
 
           timeout: Override the client-level default timeout for this request, in seconds
         """
-        return await self._get(
+        return self._get_api_list(
             "/v1/tools/",
+            page=AsyncArrayPage[Tool],
             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,
@@ -860,7 +862,7 @@ class AsyncToolsResource(AsyncAPIResource):
                     tool_list_params.ToolListParams,
                 ),
             ),
-            cast_to=ToolListResponse,
+            model=Tool,
         )
 
     async def delete(

letta_client/types/__init__.py

@@ -37,30 +37,23 @@ from .group_list_params import GroupListParams as GroupListParams
 from .identity_property import IdentityProperty as IdentityProperty
 from .model_list_params import ModelListParams as ModelListParams
 from .provider_category import ProviderCategory as ProviderCategory
-from .run_list_response import RunListResponse as RunListResponse
 from .tag_list_response import TagListResponse as TagListResponse
 from .tool_count_params import ToolCountParams as ToolCountParams
 from .continue_tool_rule import ContinueToolRule as ContinueToolRule
 from .create_block_param import CreateBlockParam as CreateBlockParam
 from .folder_list_params import FolderListParams as FolderListParams
-from .step_list_response import StepListResponse as StepListResponse
 from .terminal_tool_rule import TerminalToolRule as TerminalToolRule
 from .tool_create_params import ToolCreateParams as ToolCreateParams
-from .tool_list_response import ToolListResponse as ToolListResponse
 from .tool_update_params import ToolUpdateParams as ToolUpdateParams
 from .tool_upsert_params import ToolUpsertParams as ToolUpsertParams
 from .vector_db_provider import VectorDBProvider as VectorDBProvider
 from .agent_create_params import AgentCreateParams as AgentCreateParams
-from .agent_list_response import AgentListResponse as AgentListResponse
 from .agent_update_params import AgentUpdateParams as AgentUpdateParams
 from .archive_list_params import ArchiveListParams as ArchiveListParams
 from .batch_create_params import BatchCreateParams as BatchCreateParams
-from .batch_list_response import BatchListResponse as BatchListResponse
 from .block_create_params import BlockCreateParams as BlockCreateParams
-from .block_list_response import BlockListResponse as BlockListResponse
 from .block_update_params import BlockUpdateParams as BlockUpdateParams
 from .group_create_params import GroupCreateParams as GroupCreateParams
-from .group_list_response import GroupListResponse as GroupListResponse
 from .group_update_params import GroupUpdateParams as GroupUpdateParams
 from .model_list_response import ModelListResponse as ModelListResponse
 from .tool_count_response import ToolCountResponse as ToolCountResponse
@@ -68,7 +61,6 @@ from .tool_return_message import ToolReturnMessage as ToolReturnMessage
 from .agent_count_response import AgentCountResponse as AgentCountResponse
 from .block_count_response import BlockCountResponse as BlockCountResponse
 from .folder_create_params import FolderCreateParams as FolderCreateParams
-from .folder_list_response import FolderListResponse as FolderListResponse
 from .folder_update_params import FolderUpdateParams as FolderUpdateParams
 from .group_count_response import GroupCountResponse as GroupCountResponse
 from .identity_list_params import IdentityListParams as IdentityListParams
@@ -77,7 +69,6 @@ from .message_create_param import MessageCreateParam as MessageCreateParam
 from .text_response_format import TextResponseFormat as TextResponseFormat
 from .agent_retrieve_params import AgentRetrieveParams as AgentRetrieveParams
 from .archive_create_params import ArchiveCreateParams as ArchiveCreateParams
-from .archive_list_response import ArchiveListResponse as ArchiveListResponse
 from .archive_update_params import ArchiveUpdateParams as ArchiveUpdateParams
 from .child_tool_rule_param import ChildToolRuleParam as ChildToolRuleParam
 from .conditional_tool_rule import ConditionalToolRule as ConditionalToolRule
@@ -87,7 +78,6 @@ from .npm_requirement_param import NpmRequirementParam as NpmRequirementParam
 from .pip_requirement_param import PipRequirementParam as PipRequirementParam
 from .embedding_config_param import EmbeddingConfigParam as EmbeddingConfigParam
 from .identity_create_params import IdentityCreateParams as IdentityCreateParams
-from .identity_list_response import IdentityListResponse as IdentityListResponse
 from .identity_update_params import IdentityUpdateParams as IdentityUpdateParams
 from .identity_upsert_params import IdentityUpsertParams as IdentityUpsertParams
 from .parent_tool_rule_param import ParentToolRuleParam as ParentToolRuleParam

letta_client/types/agents/__init__.py

@@ -31,10 +31,7 @@ from .file_list_response import FileListResponse as FileListResponse
 from .file_open_response import FileOpenResponse as FileOpenResponse
 from .folder_list_params import FolderListParams as FolderListParams
 from .text_content_param import TextContentParam as TextContentParam
-from .tool_list_response import ToolListResponse as ToolListResponse
-from .block_list_response import BlockListResponse as BlockListResponse
 from .block_update_params import BlockUpdateParams as BlockUpdateParams
-from .group_list_response import GroupListResponse as GroupListResponse
 from .image_content_param import ImageContentParam as ImageContentParam
 from .letta_message_union import LettaMessageUnion as LettaMessageUnion
 from .message_list_params import MessageListParams as MessageListParams
@@ -44,7 +41,6 @@ from .folder_list_response import FolderListResponse as FolderListResponse
 from .message_reset_params import MessageResetParams as MessageResetParams
 from .approval_create_param import ApprovalCreateParam as ApprovalCreateParam
 from .message_cancel_params import MessageCancelParams as MessageCancelParams
-from .message_list_response import MessageListResponse as MessageListResponse
 from .message_stream_params import MessageStreamParams as MessageStreamParams
 from .message_update_params import MessageUpdateParams as MessageUpdateParams
 from .file_close_all_response import FileCloseAllResponse as FileCloseAllResponse

letta_client/types/agents/file_list_response.py

@@ -1,14 +1,14 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-from typing import List, Optional
+from typing import Optional
 from datetime import datetime
 
 from ..._models import BaseModel
 
-__all__ = ["FileListResponse", "File"]
+__all__ = ["FileListResponse"]
 
 
-class File(BaseModel):
+class FileListResponse(BaseModel):
     id: str
     """Unique identifier of the file-agent relationship"""
 
@@ -38,14 +38,3 @@ class File(BaseModel):
 
     visible_content: Optional[str] = None
     """Portion of the file visible to the agent if open"""
-
-
-class FileListResponse(BaseModel):
-    files: List[File]
-    """List of file attachments for the agent"""
-
-    has_more: bool
-    """Whether more results exist after this page"""
-
-    next_cursor: Optional[str] = None
-    """Cursor for fetching the next page (file-agent relationship ID)"""

letta_client/types/agents/folder_list_response.py

@@ -1,17 +1,16 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-from typing import Dict, List, Optional
+from typing import Dict, Optional
 from datetime import datetime
-from typing_extensions import TypeAlias
 
 from ..._models import BaseModel
 from ..embedding_config import EmbeddingConfig
 from ..vector_db_provider import VectorDBProvider
 
-__all__ = ["FolderListResponse", "FolderListResponseItem"]
+__all__ = ["FolderListResponse"]
 
 
-class FolderListResponseItem(BaseModel):
+class FolderListResponse(BaseModel):
     embedding_config: EmbeddingConfig
     """The embedding configuration used by the source."""
 
@@ -44,6 +43,3 @@ class FolderListResponseItem(BaseModel):
 
     vector_db_provider: Optional[VectorDBProvider] = None
     """The vector database provider used for this source's passages"""
-
-
-FolderListResponse: TypeAlias = List[FolderListResponseItem]

letta_client/types/archive_list_params.py

@@ -35,3 +35,6 @@ class ArchiveListParams(TypedDict, total=False):
 
     'asc' for oldest first, 'desc' for newest first
     """
+
+    order_by: Literal["created_at"]
+    """Field to sort by"""

letta_client/types/batches/__init__.py

@@ -3,4 +3,3 @@
 from __future__ import annotations
 
 from .message_list_params import MessageListParams as MessageListParams
-from .message_list_response import MessageListResponse as MessageListResponse

letta_client/types/blocks/__init__.py

@@ -3,4 +3,3 @@
 from __future__ import annotations
 
 from .agent_list_params import AgentListParams as AgentListParams
-from .agent_list_response import AgentListResponse as AgentListResponse

letta_client/types/folders/agent_list_response.py

@@ -1,8 +1,7 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-from typing import List
 from typing_extensions import TypeAlias
 
 __all__ = ["AgentListResponse"]
 
-AgentListResponse: TypeAlias = List[str]
+AgentListResponse: TypeAlias = str

letta_client/types/folders/file_list_response.py

@@ -1,15 +1,15 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-from typing import List, Optional
+from typing import Optional
 from datetime import datetime
-from typing_extensions import Literal, TypeAlias
+from typing_extensions import Literal
 
 from ..._models import BaseModel
 
-__all__ = ["FileListResponse", "FileListResponseItem"]
+__all__ = ["FileListResponse"]
 
 
-class FileListResponseItem(BaseModel):
+class FileListResponse(BaseModel):
     source_id: str
     """The unique identifier of the source associated with the document."""
 
@@ -63,6 +63,3 @@ class FileListResponseItem(BaseModel):
 
     updated_at: Optional[datetime] = None
     """The update date of the file."""
-
-
-FileListResponse: TypeAlias = List[FileListResponseItem]

letta_client/types/groups/__init__.py

@@ -4,7 +4,6 @@ from __future__ import annotations
 
 from .message_list_params import MessageListParams as MessageListParams
 from .message_send_params import MessageSendParams as MessageSendParams
-from .message_list_response import MessageListResponse as MessageListResponse
 from .message_stream_params import MessageStreamParams as MessageStreamParams
 from .message_update_params import MessageUpdateParams as MessageUpdateParams
 from .message_update_response import MessageUpdateResponse as MessageUpdateResponse

letta_client/types/identities/__init__.py

@@ -4,6 +4,4 @@ from __future__ import annotations
 
 from .agent_list_params import AgentListParams as AgentListParams
 from .block_list_params import BlockListParams as BlockListParams
-from .agent_list_response import AgentListResponse as AgentListResponse
-from .block_list_response import BlockListResponse as BlockListResponse
 from .property_upsert_params import PropertyUpsertParams as PropertyUpsertParams

letta_client/types/runs/__init__.py

@@ -3,8 +3,6 @@
 from __future__ import annotations
 
 from .step_list_params import StepListParams as StepListParams
-from .step_list_response import StepListResponse as StepListResponse
 from .message_list_params import MessageListParams as MessageListParams
-from .message_list_response import MessageListResponse as MessageListResponse
 from .message_stream_params import MessageStreamParams as MessageStreamParams
 from .usage_retrieve_response import UsageRetrieveResponse as UsageRetrieveResponse

letta_client/types/steps/message_list_response.py

@@ -1,6 +1,6 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-from typing import List, Union
+from typing import Union
 from typing_extensions import Annotated, TypeAlias
 
 from ..._utils import PropertyInfo
@@ -14,9 +14,9 @@ from ..agents.approval_request_message import ApprovalRequestMessage
 from ..agents.hidden_reasoning_message import HiddenReasoningMessage
 from ..agents.approval_response_message import ApprovalResponseMessage
 
-__all__ = ["MessageListResponse", "MessageListResponseItem"]
+__all__ = ["MessageListResponse"]
 
-MessageListResponseItem: TypeAlias = Annotated[
+MessageListResponse: TypeAlias = Annotated[
     Union[
         SystemMessage,
         UserMessage,
@@ -30,5 +30,3 @@ MessageListResponseItem: TypeAlias = Annotated[
     ],
     PropertyInfo(discriminator="message_type"),
 ]
-
-MessageListResponse: TypeAlias = List[MessageListResponseItem]

letta_client/types/tag_list_response.py

@@ -1,8 +1,7 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-from typing import List
 from typing_extensions import TypeAlias
 
 __all__ = ["TagListResponse"]
 
-TagListResponse: TypeAlias = List[str]
+TagListResponse: TypeAlias = str

{letta_client-1.0.0a7.dist-info → letta_client-1.0.0a9.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: letta-client
-Version: 1.0.0a7
+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