letta-client 0.1.256__py3-none-any.whl → 0.1.257__py3-none-any.whl

letta_client/__init__.py

@@ -234,6 +234,7 @@ from .types import (
     StdioServerConfig,
     Step,
     StepFeedback,
+    StepMetrics,
     StepStatus,
     StopReasonType,
     StreamableHttpServerConfig,
@@ -641,6 +642,7 @@ __all__ = [
     "StdioServerConfig",
     "Step",
     "StepFeedback",
+    "StepMetrics",
     "StepStatus",
     "StepsListRequestFeedback",
     "StopReasonType",

letta_client/core/client_wrapper.py

@@ -24,10 +24,10 @@ class BaseClientWrapper:
 
     def get_headers(self) -> typing.Dict[str, str]:
         headers: typing.Dict[str, str] = {
-            "User-Agent": "letta-client/0.1.256",
+            "User-Agent": "letta-client/0.1.257",
             "X-Fern-Language": "Python",
             "X-Fern-SDK-Name": "letta-client",
-            "X-Fern-SDK-Version": "0.1.256",
+            "X-Fern-SDK-Version": "0.1.257",
             **(self.get_custom_headers() or {}),
         }
         if self._project is not None:

letta_client/steps/client.py

@@ -5,6 +5,7 @@ import typing
 from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
 from ..core.request_options import RequestOptions
 from ..types.step import Step
+from ..types.step_metrics import StepMetrics
 from .feedback.client import AsyncFeedbackClient, FeedbackClient
 from .raw_client import AsyncRawStepsClient, RawStepsClient
 from .types.steps_list_request_feedback import StepsListRequestFeedback
@@ -156,6 +157,39 @@ class StepsClient:
         _response = self._raw_client.retrieve(step_id, request_options=request_options)
         return _response.data
 
+    def retrieve_step_metrics(
+        self, step_id: str, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> StepMetrics:
+        """
+        Get step metrics by step ID.
+
+        Parameters
+        ----------
+        step_id : str
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        StepMetrics
+            Successful Response
+
+        Examples
+        --------
+        from letta_client import Letta
+
+        client = Letta(
+            project="YOUR_PROJECT",
+            token="YOUR_TOKEN",
+        )
+        client.steps.retrieve_step_metrics(
+            step_id="step_id",
+        )
+        """
+        _response = self._raw_client.retrieve_step_metrics(step_id, request_options=request_options)
+        return _response.data
+
 
 class AsyncStepsClient:
     def __init__(self, *, client_wrapper: AsyncClientWrapper):
@@ -318,3 +352,44 @@ class AsyncStepsClient:
         """
         _response = await self._raw_client.retrieve(step_id, request_options=request_options)
         return _response.data
+
+    async def retrieve_step_metrics(
+        self, step_id: str, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> StepMetrics:
+        """
+        Get step metrics by step ID.
+
+        Parameters
+        ----------
+        step_id : str
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        StepMetrics
+            Successful Response
+
+        Examples
+        --------
+        import asyncio
+
+        from letta_client import AsyncLetta
+
+        client = AsyncLetta(
+            project="YOUR_PROJECT",
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.steps.retrieve_step_metrics(
+                step_id="step_id",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.retrieve_step_metrics(step_id, request_options=request_options)
+        return _response.data

letta_client/steps/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.step import Step
+from ..types.step_metrics import StepMetrics
 from .types.steps_list_request_feedback import StepsListRequestFeedback
 
 
@@ -183,6 +184,55 @@ class RawStepsClient:
             raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
         raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
 
+    def retrieve_step_metrics(
+        self, step_id: str, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> HttpResponse[StepMetrics]:
+        """
+        Get step metrics by step ID.
+
+        Parameters
+        ----------
+        step_id : str
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        HttpResponse[StepMetrics]
+            Successful Response
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            f"v1/steps/{jsonable_encoder(step_id)}/metrics",
+            method="GET",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    StepMetrics,
+                    construct_type(
+                        type_=StepMetrics,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return HttpResponse(response=_response, data=_data)
+            if _response.status_code == 422:
+                raise UnprocessableEntityError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        HttpValidationError,
+                        construct_type(
+                            type_=HttpValidationError,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
 
 class AsyncRawStepsClient:
     def __init__(self, *, client_wrapper: AsyncClientWrapper):
@@ -353,3 +403,52 @@ class AsyncRawStepsClient:
         except JSONDecodeError:
             raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
         raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    async def retrieve_step_metrics(
+        self, step_id: str, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> AsyncHttpResponse[StepMetrics]:
+        """
+        Get step metrics by step ID.
+
+        Parameters
+        ----------
+        step_id : str
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncHttpResponse[StepMetrics]
+            Successful Response
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            f"v1/steps/{jsonable_encoder(step_id)}/metrics",
+            method="GET",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    StepMetrics,
+                    construct_type(
+                        type_=StepMetrics,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return AsyncHttpResponse(response=_response, data=_data)
+            if _response.status_code == 422:
+                raise UnprocessableEntityError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        HttpValidationError,
+                        construct_type(
+                            type_=HttpValidationError,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)

letta_client/types/__init__.py

@@ -245,6 +245,7 @@ from .sse_server_config import SseServerConfig
 from .stdio_server_config import StdioServerConfig
 from .step import Step
 from .step_feedback import StepFeedback
+from .step_metrics import StepMetrics
 from .step_status import StepStatus
 from .stop_reason_type import StopReasonType
 from .streamable_http_server_config import StreamableHttpServerConfig
@@ -530,6 +531,7 @@ __all__ = [
     "StdioServerConfig",
     "Step",
     "StepFeedback",
+    "StepMetrics",
     "StepStatus",
     "StopReasonType",
     "StreamableHttpServerConfig",

letta_client/types/step_metrics.py

@@ -0,0 +1,68 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+from ..core.unchecked_base_model import UncheckedBaseModel
+
+
+class StepMetrics(UncheckedBaseModel):
+    id: str = pydantic.Field()
+    """
+    The id of the step this metric belongs to (matches steps.id).
+    """
+
+    provider_id: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The unique identifier of the provider.
+    """
+
+    job_id: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The unique identifier of the job.
+    """
+
+    agent_id: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The unique identifier of the agent.
+    """
+
+    llm_request_ns: typing.Optional[int] = pydantic.Field(default=None)
+    """
+    Time spent on LLM requests in nanoseconds.
+    """
+
+    tool_execution_ns: typing.Optional[int] = pydantic.Field(default=None)
+    """
+    Time spent on tool execution in nanoseconds.
+    """
+
+    step_ns: typing.Optional[int] = pydantic.Field(default=None)
+    """
+    Total time for the step in nanoseconds.
+    """
+
+    base_template_id: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The base template ID that the step belongs to (cloud only).
+    """
+
+    template_id: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The template ID that the step belongs to (cloud only).
+    """
+
+    project_id: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The project that the step belongs to (cloud only).
+    """
+
+    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

{letta_client-0.1.256.dist-info → letta_client-0.1.257.dist-info}/METADATA

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

{letta_client-0.1.256.dist-info → letta_client-0.1.257.dist-info}/RECORD

@@ -1,4 +1,4 @@
-letta_client/__init__.py,sha256=rtr9CTOq7fyIoSU6wXtwv1j8dVU-_lpQLy1wsJaJaFs,21196
+letta_client/__init__.py,sha256=EAT9kpeazjGtXHZ-FuznqefNwW251mIxdqfEgPhCwXg,21232
 letta_client/agents/__init__.py,sha256=JkuWGGNJsCfnMr2DFzQ1SiqEB1tcFZnafdidODi0_DY,2166
 letta_client/agents/blocks/__init__.py,sha256=_VhToAyIt_5axN6CLJwtxg3-CO7THa_23pbUzqhXJa4,85
 letta_client/agents/blocks/client.py,sha256=Akx-1SYEXkmdtLtytPtdFNhVts8JkjC2aMQnnWgd8Ug,14735
@@ -92,7 +92,7 @@ letta_client/client_side_access_tokens/types/client_side_access_tokens_list_clie
 letta_client/client_side_access_tokens/types/client_side_access_tokens_list_client_side_access_tokens_response_tokens_item_policy_data_item_access_item.py,sha256=kNHfEWFl7u71Pu8NPqutod0a2NXfvq8il05Hqm0iBB4,284
 letta_client/core/__init__.py,sha256=tpn7rjb6C2UIkYZYIqdrNpI7Yax2jw88sXh2baxaxAI,1715
 letta_client/core/api_error.py,sha256=44vPoTyWN59gonCIZMdzw7M1uspygiLnr3GNFOoVL2Q,614
-letta_client/core/client_wrapper.py,sha256=soND1nkEb679y6Fc_pCuaDVQMzBSPCuwMOgo72EHaqo,2776
+letta_client/core/client_wrapper.py,sha256=__QCy6F8lLEBlsgTAaIsaErVk5fb1Bo4FG2kSSR78lU,2776
 letta_client/core/datetime_utils.py,sha256=nBys2IsYrhPdszxGKCNRPSOCwa-5DWOHG95FB8G9PKo,1047
 letta_client/core/file.py,sha256=d4NNbX8XvXP32z8KpK2Xovv33nFfruIrpz0QWxlgpZk,2663
 letta_client/core/force_multipart.py,sha256=awxh5MtcRYe74ehY8U76jzv6fYM_w_D3Rur7KQQzSDk,429
@@ -188,11 +188,11 @@ letta_client/sources/passages/client.py,sha256=6wo3iTfQcDLvmS-TaoX6wUXZ31t1l3VAd
 letta_client/sources/passages/raw_client.py,sha256=iPIHJs_pmSsbyu5vBFuQdopymxlfQDkEKN4cs4YKVB8,5901
 letta_client/sources/raw_client.py,sha256=6fyI0Y_agaebPZ_lOykNf1TybmRU-09vfrYEVgyGsz0,46078
 letta_client/steps/__init__.py,sha256=aL21TXi3Lbs5vlhlmonxgk1mNdx_MRPwobryhwVelpg,204
-letta_client/steps/client.py,sha256=bVVb6po0lW3K5ko6EfrrwxP6r2sp1bZTcUJA0NAhDS8,9823
+letta_client/steps/client.py,sha256=zDoaXlSu2zLOUzXUKz3egGuc4VLE2JG_FJCXOFU6ub0,11686
 letta_client/steps/feedback/__init__.py,sha256=_VhToAyIt_5axN6CLJwtxg3-CO7THa_23pbUzqhXJa4,85
 letta_client/steps/feedback/client.py,sha256=KrblygVLvdLQDMDA7NigcR34fiJzd8xLsQQlJxzwyUA,3234
 letta_client/steps/feedback/raw_client.py,sha256=ILfN7fX-ZRl3_VpOVVBpbGMJO1twP02zLjnub23MlQE,4979
-letta_client/steps/raw_client.py,sha256=91CKYtHV365SVKzTLJLib0p-sYxhSRy421euSH9nGv4,13491
+letta_client/steps/raw_client.py,sha256=0L5g4Qkz3E15jSzXWwMX3EMwonYwI0G6j8zM7oH00BY,17243
 letta_client/steps/types/__init__.py,sha256=quEAP-ttL6qyeTg4wUY4b2m2PNbdXKqOdQVXgGk0seQ,191
 letta_client/steps/types/steps_list_request_feedback.py,sha256=Au1YSn3UYRc_b4yxUT6hFqru4iJ-SX-_Ndb3PwCYGp8,172
 letta_client/tags/__init__.py,sha256=_VhToAyIt_5axN6CLJwtxg3-CO7THa_23pbUzqhXJa4,85
@@ -228,7 +228,7 @@ letta_client/tools/types/streaming_response.py,sha256=V1qT-XAqm-z7zffJ7W1JKPCaxZ
 letta_client/tools/types/test_mcp_server_request.py,sha256=3SqjEL3EYi7iV57TjTIzuBSKv8O3Y7qSUFrCiXEvSRk,373
 letta_client/tools/types/update_mcp_server_request.py,sha256=MHouV3iyZCTROguOQP5rOYvnmvDbBeXe5VtEejRvrEs,403
 letta_client/tools/types/update_mcp_server_response.py,sha256=BJTPHWkb8hwgd4FvftQ8eZjl2QzCQT-vZAUVnLft9hw,376
-letta_client/types/__init__.py,sha256=ZfDuDphGnLFxJ_X5FCZ6Q8sOy0e2nDoRD_cAbZbDpYo,25714
+letta_client/types/__init__.py,sha256=x73IHWkxzhYCIJgthgXWlx4EJRdO5GL8dWoyXFg5rZA,25771
 letta_client/types/action_model.py,sha256=VTXavHB6J2d4MjjTMEpkuEyVaiTHyj1FGfa4j8kN6hQ,1241
 letta_client/types/action_parameters_model.py,sha256=s1mJ4tycms8UmCFsxyjKr6RbghSuqv35xpa9mK42sjg,829
 letta_client/types/action_response_model.py,sha256=LcML150OvsKimVV3sP4jSFh8pVxQXn_r_ff8DADOr3c,825
@@ -460,6 +460,7 @@ letta_client/types/sse_server_config.py,sha256=UbSmODGr5nxVMqTGtSvEbZyN2V8P_T0cO
 letta_client/types/stdio_server_config.py,sha256=kuPmwj9lDTz7jBY1jh5VH-ns3ffctWwatT_emXyyTFE,1092
 letta_client/types/step.py,sha256=r0RWvPiLUDstHKakLjMFC6SajsMNisPhiBuo32F48U4,4190
 letta_client/types/step_feedback.py,sha256=JXUkclvJ6C-6ZTgd2lteOxqEyO5KRDNQ8ronBPYMdbo,160
+letta_client/types/step_metrics.py,sha256=yR_CQL3rH7S9p5NUUzIUwUVfUxtzR99s5eSsKV3TOzg,1870
 letta_client/types/step_status.py,sha256=OruAXMfFrCL0Bgoj7Wfjr8400ok5jcV4busa9NV-KIw,179
 letta_client/types/stop_reason_type.py,sha256=BgrPBP-v9YBOpGmpusQvVQqCLPNOQFl57kVrEpPMRKU,246
 letta_client/types/streamable_http_server_config.py,sha256=GNbt2KO9VepHUtiMoK6htJLpFHcGoFJaoH1Az6zkt-Q,1776
@@ -516,6 +517,6 @@ letta_client/version.py,sha256=bttKLbIhO3UonCYQlqs600zzbQgfhCCMjeXR9WRzid4,79
 letta_client/voice/__init__.py,sha256=_VhToAyIt_5axN6CLJwtxg3-CO7THa_23pbUzqhXJa4,85
 letta_client/voice/client.py,sha256=EbIVOQh4HXqU9McATxwga08STk-HUwPEAUr_UHqyKHg,3748
 letta_client/voice/raw_client.py,sha256=KvM_3GXuSf51bubM0RVBnxvlf20qZTFMnaA_BzhXzjQ,5938
-letta_client-0.1.256.dist-info/METADATA,sha256=aiUh4WDcGc730FVAp2tnW-YVYvnJz7vxtPkIG5SjRlo,5781
-letta_client-0.1.256.dist-info/WHEEL,sha256=Zb28QaM1gQi8f4VCBhsUklF61CTlNYfs9YAZn-TOGFk,88
-letta_client-0.1.256.dist-info/RECORD,,
+letta_client-0.1.257.dist-info/METADATA,sha256=4CnkwTdoxPRFRvUMuTLGJrSmV7T11y7LRW0xSIBCxSM,5781
+letta_client-0.1.257.dist-info/WHEEL,sha256=Zb28QaM1gQi8f4VCBhsUklF61CTlNYfs9YAZn-TOGFk,88
+letta_client-0.1.257.dist-info/RECORD,,