letta-client 0.1.163__tar.gz → 0.1.165__tar.gz

{letta_client-0.1.163 → letta_client-0.1.165}/PKG-INFO

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

{letta_client-0.1.163 → letta_client-0.1.165}/pyproject.toml

@@ -3,7 +3,7 @@ name = "letta-client"
 
 [tool.poetry]
 name = "letta-client"
-version = "0.1.163"
+version = "0.1.165"
 description = ""
 readme = "README.md"
 authors = []

{letta_client-0.1.163 → letta_client-0.1.165}/src/letta_client/__init__.py

@@ -169,6 +169,7 @@ from .types import (
     PipRequirement,
     Provider,
     ProviderCategory,
+    ProviderCheck,
     ProviderTrace,
     ProviderType,
     ReasoningContent,
@@ -286,6 +287,7 @@ from .agents import (
     AgentsSearchRequestSearchItemOperator,
     AgentsSearchRequestSearchItemTwo,
     AgentsSearchRequestSearchItemZero,
+    AgentsSearchRequestSortBy,
     AgentsSearchResponse,
     CreateAgentRequestResponseFormat,
     CreateAgentRequestToolRulesItem,
@@ -334,6 +336,7 @@ __all__ = [
     "AgentsSearchRequestSearchItemOperator",
     "AgentsSearchRequestSearchItemTwo",
     "AgentsSearchRequestSearchItemZero",
+    "AgentsSearchRequestSortBy",
     "AgentsSearchResponse",
     "AppAuthScheme",
     "AppAuthSchemeAuthMode",
@@ -515,6 +518,7 @@ __all__ = [
     "ProjectsListResponseProjectsItem",
     "Provider",
     "ProviderCategory",
+    "ProviderCheck",
     "ProviderTrace",
     "ProviderType",
     "ReasoningContent",

{letta_client-0.1.163 → letta_client-0.1.165}/src/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-0.1.163 → letta_client-0.1.165}/src/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-0.1.163 → letta_client-0.1.165}/src/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-0.1.165/src/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-0.1.163 → letta_client-0.1.165}/src/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.163",
+            "X-Fern-SDK-Version": "0.1.165",
         }
         if self.token is not None:
             headers["Authorization"] = f"Bearer {self.token}"

{letta_client-0.1.163 → letta_client-0.1.165}/src/letta_client/providers/client.py

@@ -101,6 +101,8 @@ class ProvidersClient:
         name: str,
         provider_type: ProviderType,
         api_key: str,
+        access_key: typing.Optional[str] = OMIT,
+        region: typing.Optional[str] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> Provider:
         """
@@ -115,7 +117,13 @@ class ProvidersClient:
             The type of the provider.
 
         api_key : str
-            API key used for requests to the provider.
+            API key or secret key used for requests to the provider.
+
+        access_key : typing.Optional[str]
+            Access key used for requests to the provider.
+
+        region : typing.Optional[str]
+            Region used for requests to the provider.
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -145,6 +153,8 @@ class ProvidersClient:
                 "name": name,
                 "provider_type": provider_type,
                 "api_key": api_key,
+                "access_key": access_key,
+                "region": region,
             },
             headers={
                 "content-type": "application/json",
@@ -235,7 +245,13 @@ class ProvidersClient:
         raise ApiError(status_code=_response.status_code, body=_response_json)
 
     def modify(
-        self, provider_id: str, *, api_key: str, request_options: typing.Optional[RequestOptions] = None
+        self,
+        provider_id: str,
+        *,
+        api_key: str,
+        access_key: typing.Optional[str] = OMIT,
+        region: typing.Optional[str] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
     ) -> Provider:
         """
         Update an existing custom provider
@@ -245,7 +261,13 @@ class ProvidersClient:
         provider_id : str
 
         api_key : str
-            API key used for requests to the provider.
+            API key or secret key used for requests to the provider.
+
+        access_key : typing.Optional[str]
+            Access key used for requests to the provider.
+
+        region : typing.Optional[str]
+            Region used for requests to the provider.
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -272,6 +294,8 @@ class ProvidersClient:
             method="PATCH",
             json={
                 "api_key": api_key,
+                "access_key": access_key,
+                "region": region,
             },
             headers={
                 "content-type": "application/json",
@@ -303,16 +327,10 @@ class ProvidersClient:
             raise ApiError(status_code=_response.status_code, body=_response.text)
         raise ApiError(status_code=_response.status_code, body=_response_json)
 
-    def check(
-        self, *, provider_type: ProviderType, api_key: str, request_options: typing.Optional[RequestOptions] = None
-    ) -> typing.Optional[typing.Any]:
+    def check(self, *, request_options: typing.Optional[RequestOptions] = None) -> typing.Optional[typing.Any]:
         """
         Parameters
         ----------
-        provider_type : ProviderType
-
-        api_key : str
-
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -328,20 +346,11 @@ class ProvidersClient:
         client = Letta(
             token="YOUR_TOKEN",
         )
-        client.providers.check(
-            api_key="x-api-key",
-            provider_type="anthropic",
-        )
+        client.providers.check()
         """
         _response = self._client_wrapper.httpx_client.request(
             "v1/providers/check",
             method="GET",
-            params={
-                "provider_type": provider_type,
-            },
-            headers={
-                "x-api-key": str(api_key) if api_key is not None else None,
-            },
             request_options=request_options,
         )
         try:
@@ -461,6 +470,8 @@ class AsyncProvidersClient:
         name: str,
         provider_type: ProviderType,
         api_key: str,
+        access_key: typing.Optional[str] = OMIT,
+        region: typing.Optional[str] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> Provider:
         """
@@ -475,7 +486,13 @@ class AsyncProvidersClient:
             The type of the provider.
 
         api_key : str
-            API key used for requests to the provider.
+            API key or secret key used for requests to the provider.
+
+        access_key : typing.Optional[str]
+            Access key used for requests to the provider.
+
+        region : typing.Optional[str]
+            Region used for requests to the provider.
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -513,6 +530,8 @@ class AsyncProvidersClient:
                 "name": name,
                 "provider_type": provider_type,
                 "api_key": api_key,
+                "access_key": access_key,
+                "region": region,
             },
             headers={
                 "content-type": "application/json",
@@ -611,7 +630,13 @@ class AsyncProvidersClient:
         raise ApiError(status_code=_response.status_code, body=_response_json)
 
     async def modify(
-        self, provider_id: str, *, api_key: str, request_options: typing.Optional[RequestOptions] = None
+        self,
+        provider_id: str,
+        *,
+        api_key: str,
+        access_key: typing.Optional[str] = OMIT,
+        region: typing.Optional[str] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
     ) -> Provider:
         """
         Update an existing custom provider
@@ -621,7 +646,13 @@ class AsyncProvidersClient:
         provider_id : str
 
         api_key : str
-            API key used for requests to the provider.
+            API key or secret key used for requests to the provider.
+
+        access_key : typing.Optional[str]
+            Access key used for requests to the provider.
+
+        region : typing.Optional[str]
+            Region used for requests to the provider.
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -656,6 +687,8 @@ class AsyncProvidersClient:
             method="PATCH",
             json={
                 "api_key": api_key,
+                "access_key": access_key,
+                "region": region,
             },
             headers={
                 "content-type": "application/json",
@@ -687,16 +720,10 @@ class AsyncProvidersClient:
             raise ApiError(status_code=_response.status_code, body=_response.text)
         raise ApiError(status_code=_response.status_code, body=_response_json)
 
-    async def check(
-        self, *, provider_type: ProviderType, api_key: str, request_options: typing.Optional[RequestOptions] = None
-    ) -> typing.Optional[typing.Any]:
+    async def check(self, *, request_options: typing.Optional[RequestOptions] = None) -> typing.Optional[typing.Any]:
         """
         Parameters
         ----------
-        provider_type : ProviderType
-
-        api_key : str
-
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -717,10 +744,7 @@ class AsyncProvidersClient:
 
 
         async def main() -> None:
-            await client.providers.check(
-                api_key="x-api-key",
-                provider_type="anthropic",
-            )
+            await client.providers.check()
 
 
         asyncio.run(main())
@@ -728,12 +752,6 @@ class AsyncProvidersClient:
         _response = await self._client_wrapper.httpx_client.request(
             "v1/providers/check",
             method="GET",
-            params={
-                "provider_type": provider_type,
-            },
-            headers={
-                "x-api-key": str(api_key) if api_key is not None else None,
-            },
             request_options=request_options,
         )
         try:

{letta_client-0.1.163 → letta_client-0.1.165}/src/letta_client/types/__init__.py

@@ -172,6 +172,7 @@ from .payment_required_error_body import PaymentRequiredErrorBody
 from .pip_requirement import PipRequirement
 from .provider import Provider
 from .provider_category import ProviderCategory
+from .provider_check import ProviderCheck
 from .provider_trace import ProviderTrace
 from .provider_type import ProviderType
 from .reasoning_content import ReasoningContent
@@ -420,6 +421,7 @@ __all__ = [
     "PipRequirement",
     "Provider",
     "ProviderCategory",
+    "ProviderCheck",
     "ProviderTrace",
     "ProviderType",
     "ReasoningContent",

{letta_client-0.1.163 → letta_client-0.1.165}/src/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.163 → letta_client-0.1.165}/src/letta_client/types/provider.py

@@ -32,7 +32,7 @@ class Provider(UncheckedBaseModel):
 
     api_key: typing.Optional[str] = pydantic.Field(default=None)
     """
-    API key used for requests to the provider.
+    API key or secret key used for requests to the provider.
     """
 
     base_url: typing.Optional[str] = pydantic.Field(default=None)
@@ -40,6 +40,16 @@ class Provider(UncheckedBaseModel):
     Base URL for the provider.
     """
 
+    access_key: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    Access key used for requests to the provider.
+    """
+
+    region: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    Region used for requests to the provider.
+    """
+
     updated_at: typing.Optional[dt.datetime] = pydantic.Field(default=None)
     """
     The last update timestamp of the provider.

letta_client-0.1.165/src/letta_client/types/provider_check.py

@@ -0,0 +1,38 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.unchecked_base_model import UncheckedBaseModel
+from .provider_type import ProviderType
+import pydantic
+import typing
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+
+
+class ProviderCheck(UncheckedBaseModel):
+    provider_type: ProviderType = pydantic.Field()
+    """
+    The type of the provider.
+    """
+
+    api_key: str = pydantic.Field()
+    """
+    API key or secret key used for requests to the provider.
+    """
+
+    access_key: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    Access key used for requests to the provider.
+    """
+
+    region: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    Region used for requests to the provider.
+    """
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow