letta-client 0.1.164__py3-none-any.whl → 0.1.165__py3-none-any.whl

letta_client/__init__.py

@@ -287,6 +287,7 @@ from .agents import (
     AgentsSearchRequestSearchItemOperator,
     AgentsSearchRequestSearchItemTwo,
     AgentsSearchRequestSearchItemZero,
+    AgentsSearchRequestSortBy,
     AgentsSearchResponse,
     CreateAgentRequestResponseFormat,
     CreateAgentRequestToolRulesItem,
@@ -335,6 +336,7 @@ __all__ = [
     "AgentsSearchRequestSearchItemOperator",
     "AgentsSearchRequestSearchItemTwo",
     "AgentsSearchRequestSearchItemZero",
+    "AgentsSearchRequestSortBy",
     "AgentsSearchResponse",
     "AppAuthScheme",
     "AppAuthSchemeAuthMode",

letta_client/agents/__init__.py

@@ -7,6 +7,7 @@ from .types import (
     AgentsSearchRequestSearchItemOperator,
     AgentsSearchRequestSearchItemTwo,
     AgentsSearchRequestSearchItemZero,
+    AgentsSearchRequestSortBy,
     AgentsSearchResponse,
     CreateAgentRequestResponseFormat,
     CreateAgentRequestToolRulesItem,
@@ -25,6 +26,7 @@ __all__ = [
     "AgentsSearchRequestSearchItemOperator",
     "AgentsSearchRequestSearchItemTwo",
     "AgentsSearchRequestSearchItemZero",
+    "AgentsSearchRequestSortBy",
     "AgentsSearchResponse",
     "CreateAgentRequestResponseFormat",
     "CreateAgentRequestToolRulesItem",

letta_client/agents/client.py

@@ -31,7 +31,9 @@ from ..core.jsonable_encoder import jsonable_encoder
 from .. import core
 from .types.update_agent_tool_rules_item import UpdateAgentToolRulesItem
 from .types.update_agent_response_format import UpdateAgentResponseFormat
+import datetime as dt
 from .types.agents_search_request_search_item import AgentsSearchRequestSearchItem
+from .types.agents_search_request_sort_by import AgentsSearchRequestSortBy
 from .types.agents_search_response import AgentsSearchResponse
 from ..core.client_wrapper import AsyncClientWrapper
 from .context.client import AsyncContextClient
@@ -80,6 +82,7 @@ class AgentsClient:
         identifier_keys: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
         include_relationships: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
         ascending: typing.Optional[bool] = None,
+        sort_by: typing.Optional[str] = None,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> typing.List[AgentState]:
         """
@@ -132,6 +135,9 @@ class AgentsClient:
         ascending : typing.Optional[bool]
             Whether to sort agents oldest to newest (True) or newest to oldest (False, default)
 
+        sort_by : typing.Optional[str]
+            Field to sort by. Options: 'created_at' (default), 'last_run_completion'
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -167,6 +173,7 @@ class AgentsClient:
                 "identifier_keys": identifier_keys,
                 "include_relationships": include_relationships,
                 "ascending": ascending,
+                "sort_by": sort_by,
             },
             request_options=request_options,
         )
@@ -804,6 +811,8 @@ class AgentsClient:
         embedding: typing.Optional[str] = OMIT,
         enable_sleeptime: typing.Optional[bool] = OMIT,
         response_format: typing.Optional[UpdateAgentResponseFormat] = OMIT,
+        last_run_completion: typing.Optional[dt.datetime] = OMIT,
+        last_run_duration_ms: typing.Optional[int] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> AgentState:
         """
@@ -879,6 +888,12 @@ class AgentsClient:
         response_format : typing.Optional[UpdateAgentResponseFormat]
             The response format for the agent.
 
+        last_run_completion : typing.Optional[dt.datetime]
+            The timestamp when the agent last completed a run.
+
+        last_run_duration_ms : typing.Optional[int]
+            The duration in milliseconds of the agent's last run.
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -932,6 +947,8 @@ class AgentsClient:
                 "response_format": convert_and_respect_annotation_metadata(
                     object_=response_format, annotation=UpdateAgentResponseFormat, direction="write"
                 ),
+                "last_run_completion": last_run_completion,
+                "last_run_duration_ms": last_run_duration_ms,
             },
             headers={
                 "content-type": "application/json",
@@ -1039,6 +1056,8 @@ class AgentsClient:
         combinator: typing.Optional[typing.Literal["AND"]] = OMIT,
         limit: typing.Optional[float] = OMIT,
         after: typing.Optional[str] = OMIT,
+        sort_by: typing.Optional[AgentsSearchRequestSortBy] = OMIT,
+        ascending: typing.Optional[bool] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> AgentsSearchResponse:
         """
@@ -1058,6 +1077,10 @@ class AgentsClient:
 
         after : typing.Optional[str]
 
+        sort_by : typing.Optional[AgentsSearchRequestSortBy]
+
+        ascending : typing.Optional[bool]
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -1086,6 +1109,8 @@ class AgentsClient:
                 "combinator": combinator,
                 "limit": limit,
                 "after": after,
+                "sortBy": sort_by,
+                "ascending": ascending,
             },
             headers={
                 "content-type": "application/json",
@@ -1139,6 +1164,7 @@ class AsyncAgentsClient:
         identifier_keys: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
         include_relationships: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
         ascending: typing.Optional[bool] = None,
+        sort_by: typing.Optional[str] = None,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> typing.List[AgentState]:
         """
@@ -1191,6 +1217,9 @@ class AsyncAgentsClient:
         ascending : typing.Optional[bool]
             Whether to sort agents oldest to newest (True) or newest to oldest (False, default)
 
+        sort_by : typing.Optional[str]
+            Field to sort by. Options: 'created_at' (default), 'last_run_completion'
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -1234,6 +1263,7 @@ class AsyncAgentsClient:
                 "identifier_keys": identifier_keys,
                 "include_relationships": include_relationships,
                 "ascending": ascending,
+                "sort_by": sort_by,
             },
             request_options=request_options,
         )
@@ -1919,6 +1949,8 @@ class AsyncAgentsClient:
         embedding: typing.Optional[str] = OMIT,
         enable_sleeptime: typing.Optional[bool] = OMIT,
         response_format: typing.Optional[UpdateAgentResponseFormat] = OMIT,
+        last_run_completion: typing.Optional[dt.datetime] = OMIT,
+        last_run_duration_ms: typing.Optional[int] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> AgentState:
         """
@@ -1994,6 +2026,12 @@ class AsyncAgentsClient:
         response_format : typing.Optional[UpdateAgentResponseFormat]
             The response format for the agent.
 
+        last_run_completion : typing.Optional[dt.datetime]
+            The timestamp when the agent last completed a run.
+
+        last_run_duration_ms : typing.Optional[int]
+            The duration in milliseconds of the agent's last run.
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -2055,6 +2093,8 @@ class AsyncAgentsClient:
                 "response_format": convert_and_respect_annotation_metadata(
                     object_=response_format, annotation=UpdateAgentResponseFormat, direction="write"
                 ),
+                "last_run_completion": last_run_completion,
+                "last_run_duration_ms": last_run_duration_ms,
             },
             headers={
                 "content-type": "application/json",
@@ -2170,6 +2210,8 @@ class AsyncAgentsClient:
         combinator: typing.Optional[typing.Literal["AND"]] = OMIT,
         limit: typing.Optional[float] = OMIT,
         after: typing.Optional[str] = OMIT,
+        sort_by: typing.Optional[AgentsSearchRequestSortBy] = OMIT,
+        ascending: typing.Optional[bool] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> AgentsSearchResponse:
         """
@@ -2189,6 +2231,10 @@ class AsyncAgentsClient:
 
         after : typing.Optional[str]
 
+        sort_by : typing.Optional[AgentsSearchRequestSortBy]
+
+        ascending : typing.Optional[bool]
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -2225,6 +2271,8 @@ class AsyncAgentsClient:
                 "combinator": combinator,
                 "limit": limit,
                 "after": after,
+                "sortBy": sort_by,
+                "ascending": ascending,
             },
             headers={
                 "content-type": "application/json",

letta_client/agents/types/__init__.py

@@ -6,6 +6,7 @@ from .agents_search_request_search_item_one_operator import AgentsSearchRequestS
 from .agents_search_request_search_item_operator import AgentsSearchRequestSearchItemOperator
 from .agents_search_request_search_item_two import AgentsSearchRequestSearchItemTwo
 from .agents_search_request_search_item_zero import AgentsSearchRequestSearchItemZero
+from .agents_search_request_sort_by import AgentsSearchRequestSortBy
 from .agents_search_response import AgentsSearchResponse
 from .create_agent_request_response_format import CreateAgentRequestResponseFormat
 from .create_agent_request_tool_rules_item import CreateAgentRequestToolRulesItem
@@ -19,6 +20,7 @@ __all__ = [
     "AgentsSearchRequestSearchItemOperator",
     "AgentsSearchRequestSearchItemTwo",
     "AgentsSearchRequestSearchItemZero",
+    "AgentsSearchRequestSortBy",
     "AgentsSearchResponse",
     "CreateAgentRequestResponseFormat",
     "CreateAgentRequestToolRulesItem",

letta_client/agents/types/agents_search_request_sort_by.py

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

letta_client/core/client_wrapper.py

@@ -16,7 +16,7 @@ class BaseClientWrapper:
         headers: typing.Dict[str, str] = {
             "X-Fern-Language": "Python",
             "X-Fern-SDK-Name": "letta-client",
-            "X-Fern-SDK-Version": "0.1.164",
+            "X-Fern-SDK-Version": "0.1.165",
         }
         if self.token is not None:
             headers["Authorization"] = f"Bearer {self.token}"

letta_client/types/agent_state.py

@@ -170,6 +170,16 @@ class AgentState(UncheckedBaseModel):
     The multi-agent group that this agent manages
     """
 
+    last_run_completion: typing.Optional[dt.datetime] = pydantic.Field(default=None)
+    """
+    The timestamp when the agent last completed a run.
+    """
+
+    last_run_duration_ms: typing.Optional[int] = pydantic.Field(default=None)
+    """
+    The duration in milliseconds of the agent's last run.
+    """
+
     if IS_PYDANTIC_V2:
         model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
     else:

{letta_client-0.1.164.dist-info → letta_client-0.1.165.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: letta-client
-Version: 0.1.164
+Version: 0.1.165
 Summary: 
 Requires-Python: >=3.8,<4.0
 Classifier: Intended Audience :: Developers

{letta_client-0.1.164.dist-info → letta_client-0.1.165.dist-info}/RECORD

@@ -1,8 +1,8 @@
-letta_client/__init__.py,sha256=ODj1hJIjnt0oi2oxEA6Tg5phu0QfxXWI2xK56wtCbzg,17584
-letta_client/agents/__init__.py,sha256=3oFWVxaaxkphkjGJVk31Llb9ll9dKoCGx3B_r3qqtes,1716
+letta_client/__init__.py,sha256=Dlv6NmNpxz9fGrD0dBUyZI7NS4IRMN5kESVb4UHT8Vo,17648
+letta_client/agents/__init__.py,sha256=c_9OiE6ofyiPcq9BP37qvo7h0SKmw34PKN3KMxuRja0,1780
 letta_client/agents/blocks/__init__.py,sha256=FTtvy8EDg9nNNg9WCatVgKTRYV8-_v1roeGPAKoa_pw,65
 letta_client/agents/blocks/client.py,sha256=ecE03lE5tP1AtCMFLT9FzdYyQMx_D7NI5m42b41pV40,24684
-letta_client/agents/client.py,sha256=pUm0I57mZZgyd-w5ZZSOemNXpcz9TnIK3Pr7EtX6z60,85828
+letta_client/agents/client.py,sha256=baQrl1WhyBWCLe5Ve4TIIQRm8_EBk3K8YxH6TetJCaU,87911
 letta_client/agents/context/__init__.py,sha256=FTtvy8EDg9nNNg9WCatVgKTRYV8-_v1roeGPAKoa_pw,65
 letta_client/agents/context/client.py,sha256=GKKvoG4N_K8Biz9yDjeIHpFG0C8Cwc7tHmEX3pTL_9U,4815
 letta_client/agents/core_memory/__init__.py,sha256=FTtvy8EDg9nNNg9WCatVgKTRYV8-_v1roeGPAKoa_pw,65
@@ -31,13 +31,14 @@ letta_client/agents/templates/types/templates_create_version_request_return_agen
 letta_client/agents/templates/types/templates_migrate_response.py,sha256=7N4JtAaiao-LrNdi72K7XB01uXJVkczaKYIJIMf0QYs,577
 letta_client/agents/tools/__init__.py,sha256=FTtvy8EDg9nNNg9WCatVgKTRYV8-_v1roeGPAKoa_pw,65
 letta_client/agents/tools/client.py,sha256=xZMRZhG8mI_h8_QqgI4lXh3FieRCLeoPwdtB56GB-XU,12685
-letta_client/agents/types/__init__.py,sha256=vvqKyhe98ZbR5QoK7VWHSVrjLYPuUo-Xlky1aAAv8Ek,1386
+letta_client/agents/types/__init__.py,sha256=wh0A9KuavtD9a4NHJcjTG0Ok5xSsYipw1MVG-O_rR8E,1488
 letta_client/agents/types/agents_search_request_search_item.py,sha256=oIWRth_5r-3Fd_rROsEsc7XIvC0yRYv4BxdPKuUl6CI,634
 letta_client/agents/types/agents_search_request_search_item_one.py,sha256=ECWv-hDZen6AomM01zmRsOz0PlXVEwIwLHjid9yko9o,779
 letta_client/agents/types/agents_search_request_search_item_one_operator.py,sha256=S1qYdfdUqUgZ0DzQ53x7GN_qa_4NypO7-qNkkxgsbQc,182
 letta_client/agents/types/agents_search_request_search_item_operator.py,sha256=q9wNF1ubm5zw8_tykL4JWPEOH7SFLYLeTikjAszpZq8,678
 letta_client/agents/types/agents_search_request_search_item_two.py,sha256=YBC-rhz_ToN948VyRy5VB1yT4JqtYcLD_V9hNrkgnfQ,690
 letta_client/agents/types/agents_search_request_search_item_zero.py,sha256=tGjwnFqSofFMBSAogmPLEflDQZ2rMqoMfFUtaIpND18,630
+letta_client/agents/types/agents_search_request_sort_by.py,sha256=svlezWF0A2JQlEnjjIXTMJnkrCjRot1r7ITCP1nQ4iQ,186
 letta_client/agents/types/agents_search_response.py,sha256=AQJVKps-bjCx2ujqESzW1Iy9ZYFS17hH_UFIeBeK4S8,815
 letta_client/agents/types/create_agent_request_response_format.py,sha256=1GUV3rFMj46bYpRHOB_H_WMNrQ5FkKIidKg60u8szHM,409
 letta_client/agents/types/create_agent_request_tool_rules_item.py,sha256=L3FNsFTG9kVmuPbQhbCKNg3H2E5bB2Rgp92gWmGd-LM,689
@@ -62,7 +63,7 @@ letta_client/client_side_access_tokens/types/client_side_access_tokens_create_re
 letta_client/client_side_access_tokens/types/client_side_access_tokens_create_response_policy_data_item_access_item.py,sha256=R-H25IpNp9feSrW8Yj3h9O3UTMVvFniQJElogKxLuoE,254
 letta_client/core/__init__.py,sha256=OKbX2aCZXgHCDUsCouqv-OiX32xA6eFFCKIUH9M5Vzk,1591
 letta_client/core/api_error.py,sha256=RE8LELok2QCjABadECTvtDp7qejA1VmINCh6TbqPwSE,426
-letta_client/core/client_wrapper.py,sha256=H3hLb75t8Rdf8-7Q7YL-14jLBV7EA4Fzu2bz3BDC0Ug,1998
+letta_client/core/client_wrapper.py,sha256=dSomxhm2N6ZppvWcTyP1WFdUcaKze16CLsu_9Tjp6eM,1998
 letta_client/core/datetime_utils.py,sha256=nBys2IsYrhPdszxGKCNRPSOCwa-5DWOHG95FB8G9PKo,1047
 letta_client/core/file.py,sha256=d4NNbX8XvXP32z8KpK2Xovv33nFfruIrpz0QWxlgpZk,2663
 letta_client/core/http_client.py,sha256=Z77OIxIbL4OAB2IDqjRq_sYa5yNYAWfmdhdCSSvh6Y4,19552
@@ -159,7 +160,7 @@ letta_client/types/action_response_model.py,sha256=yq2Fd9UU8j7vvtE3VqXUoRRvDzWcf
 letta_client/types/agent_environment_variable.py,sha256=vutZLcR0yETltgOZ7E_o9kR4vOdBxybVL9lzXSux75w,1698
 letta_client/types/agent_schema.py,sha256=uTSjFAsnEYdOX-PRD2vHbn69JBe8GKbctvlDOP85k_U,1784
 letta_client/types/agent_schema_tool_rules_item.py,sha256=TTP7uKYPSe-EAl4p03j0Kd-W9tG5T6gfaWIUBAOVv9U,482
-letta_client/types/agent_state.py,sha256=oLgHlraP7C5FnSGzzDBqKsXwKHJz-OYFbToAqFUQ8iI,5621
+letta_client/types/agent_state.py,sha256=A_ehJ1jirLIBDfYbr8hyWmga3C9f8SmmNHf60j_q4_g,5931
 letta_client/types/agent_state_response_format.py,sha256=HISBgCumQxw6nQeDUMBu-IlghaLeWRb7BHHNaz_e8Hc,377
 letta_client/types/agent_state_tool_rules_item.py,sha256=WB-N4uyDTfhYBjQYDcLZDxDj73Xu1mQasBkdofUM-XU,625
 letta_client/types/agent_type.py,sha256=C7krJfPZvZDZrEqizp5UdUF4T6omXIu8m1XgVgg7JKc,321
@@ -403,6 +404,6 @@ letta_client/types/web_search_options_user_location_approximate.py,sha256=Ywk01J
 letta_client/version.py,sha256=bttKLbIhO3UonCYQlqs600zzbQgfhCCMjeXR9WRzid4,79
 letta_client/voice/__init__.py,sha256=FTtvy8EDg9nNNg9WCatVgKTRYV8-_v1roeGPAKoa_pw,65
 letta_client/voice/client.py,sha256=EX79F2D5bieXNP8g1ZPw8xwAzqE1A3hshCHUSlTV1kw,5739
-letta_client-0.1.164.dist-info/METADATA,sha256=4kDGXsvMCxGy7NosndMsL5ipb9o8ITQqOwN5KccoYy4,5093
-letta_client-0.1.164.dist-info/WHEEL,sha256=Zb28QaM1gQi8f4VCBhsUklF61CTlNYfs9YAZn-TOGFk,88
-letta_client-0.1.164.dist-info/RECORD,,
+letta_client-0.1.165.dist-info/METADATA,sha256=3a_wwcOwnbwLhFoUkiH1tKgWl1AuZ0zjjzkOzFiv-_k,5093
+letta_client-0.1.165.dist-info/WHEEL,sha256=Zb28QaM1gQi8f4VCBhsUklF61CTlNYfs9YAZn-TOGFk,88
+letta_client-0.1.165.dist-info/RECORD,,