letta-client 0.1.324__py3-none-any.whl → 1.0.0a2__py3-none-any.whl

letta_client/types/run_metrics.py

@@ -0,0 +1,58 @@
+# 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 RunMetrics(UncheckedBaseModel):
+    id: str = pydantic.Field()
+    """
+    The id of the run this metric belongs to (matches runs.id).
+    """
+
+    agent_id: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The unique identifier of the agent.
+    """
+
+    project_id: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The project that the run belongs to (cloud only).
+    """
+
+    run_start_ns: typing.Optional[int] = pydantic.Field(default=None)
+    """
+    The timestamp of the start of the run in nanoseconds.
+    """
+
+    run_ns: typing.Optional[int] = pydantic.Field(default=None)
+    """
+    Total time for the run in nanoseconds.
+    """
+
+    num_steps: typing.Optional[int] = pydantic.Field(default=None)
+    """
+    The number of steps in the run.
+    """
+
+    template_id: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The template ID that the run belongs to (cloud only).
+    """
+
+    base_template_id: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The base template ID that the run 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/types/run_status.py

@@ -0,0 +1,5 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+RunStatus = typing.Union[typing.Literal["created", "running", "completed", "failed", "cancelled"], typing.Any]

letta_client/types/sandbox_environment_variable.py

@@ -49,6 +49,11 @@ class SandboxEnvironmentVariable(UncheckedBaseModel):
     An optional description of the environment variable.
     """
 
+    value_enc: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    Encrypted value as Secret object
+    """
+
     sandbox_config_id: str = pydantic.Field()
     """
     The ID of the sandbox config this environment variable belongs to.

letta_client/types/step.py

@@ -27,9 +27,9 @@ class Step(UncheckedBaseModel):
     The unique identifier of the provider that was configured for this step
     """
 
-    job_id: typing.Optional[str] = pydantic.Field(default=None)
+    run_id: typing.Optional[str] = pydantic.Field(default=None)
     """
-    The unique identifier of the job that this step belongs to. Only included for async calls.
+    The unique identifier of the run that this step belongs to. Only included for async calls.
     """
 
     agent_id: typing.Optional[str] = pydantic.Field(default=None)

letta_client/types/step_metrics.py

@@ -18,9 +18,9 @@ class StepMetrics(UncheckedBaseModel):
     The unique identifier of the provider.
     """
 
-    job_id: typing.Optional[str] = pydantic.Field(default=None)
+    run_id: typing.Optional[str] = pydantic.Field(default=None)
     """
-    The unique identifier of the job.
+    The unique identifier of the run.
     """
 
     agent_id: typing.Optional[str] = pydantic.Field(default=None)

letta_client/types/text_content.py

@@ -14,6 +14,11 @@ class TextContent(UncheckedBaseModel):
     The text content of the message.
     """
 
+    signature: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    Stores a unique identifier for any reasoning associated with this text content.
+    """
+
     if IS_PYDANTIC_V2:
         model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
     else:

letta_client/types/tool_call_content.py

@@ -24,6 +24,11 @@ class ToolCallContent(UncheckedBaseModel):
     The parameters being passed to the tool, structured as a dictionary of parameter names to values.
     """
 
+    signature: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    Stores a unique identifier for any reasoning associated with this tool call.
+    """
+
     if IS_PYDANTIC_V2:
         model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
     else:

letta_client/types/tool_call_message.py

@@ -7,6 +7,7 @@ import pydantic
 from ..core.pydantic_utilities import IS_PYDANTIC_V2
 from ..core.unchecked_base_model import UncheckedBaseModel
 from .tool_call_message_tool_call import ToolCallMessageToolCall
+from .tool_call_message_tool_calls import ToolCallMessageToolCalls
 
 
 class ToolCallMessage(UncheckedBaseModel):
@@ -31,6 +32,7 @@ class ToolCallMessage(UncheckedBaseModel):
     seq_id: typing.Optional[int] = None
     run_id: typing.Optional[str] = None
     tool_call: ToolCallMessageToolCall
+    tool_calls: typing.Optional[ToolCallMessageToolCalls] = None
 
     if IS_PYDANTIC_V2:
         model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2

letta_client/types/tool_call_message_tool_calls.py

@@ -0,0 +1,8 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+from .tool_call import ToolCall
+from .tool_call_delta import ToolCallDelta
+
+ToolCallMessageToolCalls = typing.Union[typing.List[ToolCall], ToolCallDelta]

letta_client/types/tool_call_node.py

@@ -0,0 +1,35 @@
+# 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 ToolCallNode(UncheckedBaseModel):
+    """
+    Typed child override for prefilled arguments.
+
+    When used in a ChildToolRule, if this child is selected next, its `args` will be
+    applied as prefilled arguments (overriding overlapping LLM-provided values).
+    """
+
+    name: str = pydantic.Field()
+    """
+    The name of the child tool to invoke next.
+    """
+
+    args: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = pydantic.Field(default=None)
+    """
+    Optional prefilled arguments for this child tool. Keys must match the tool's parameter names and values must satisfy the tool's JSON schema. Supports partial prefill; non-overlapping parameters are left to the model.
+    """
+
+    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/types/tool_return_message.py

@@ -6,6 +6,7 @@ import typing
 import pydantic
 from ..core.pydantic_utilities import IS_PYDANTIC_V2
 from ..core.unchecked_base_model import UncheckedBaseModel
+from .letta_schemas_letta_message_tool_return import LettaSchemasLettaMessageToolReturn
 from .tool_return_message_status import ToolReturnMessageStatus
 
 
@@ -17,11 +18,12 @@ class ToolReturnMessage(UncheckedBaseModel):
         id (str): The ID of the message
         date (datetime): The date the message was created in ISO format
         name (Optional[str]): The name of the sender of the message
-        tool_return (str): The return value of the tool
-        status (Literal["success", "error"]): The status of the tool call
-        tool_call_id (str): A unique identifier for the tool call that generated this message
-        stdout (Optional[List(str)]): Captured stdout (e.g. prints, logs) from the tool invocation
-        stderr (Optional[List(str)]): Captured stderr from the tool invocation
+        tool_return (str): The return value of the tool (deprecated, use tool_returns)
+        status (Literal["success", "error"]): The status of the tool call (deprecated, use tool_returns)
+        tool_call_id (str): A unique identifier for the tool call that generated this message (deprecated, use tool_returns)
+        stdout (Optional[List(str)]): Captured stdout (e.g. prints, logs) from the tool invocation (deprecated, use tool_returns)
+        stderr (Optional[List(str)]): Captured stderr from the tool invocation (deprecated, use tool_returns)
+        tool_returns (Optional[List[ToolReturn]]): List of tool returns for multi-tool support
     """
 
     id: str
@@ -39,6 +41,7 @@ class ToolReturnMessage(UncheckedBaseModel):
     tool_call_id: str
     stdout: typing.Optional[typing.List[str]] = None
     stderr: typing.Optional[typing.List[str]] = None
+    tool_returns: typing.Optional[typing.List[LettaSchemasLettaMessageToolReturn]] = None
 
     if IS_PYDANTIC_V2:
         model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2

letta_client/types/tool_type.py

@@ -12,8 +12,8 @@ ToolType = typing.Union[
         "letta_voice_sleeptime_core",
         "letta_builtin",
         "letta_files_core",
-        "external_composio",
         "external_langchain",
+        "external_composio",
         "external_mcp",
     ],
     typing.Any,

letta_client/types/top_logprob.py

@@ -0,0 +1,22 @@
+# 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 TopLogprob(UncheckedBaseModel):
+    token: str
+    bytes: typing.Optional[typing.List[int]] = None
+    logprob: float
+
+    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/voice/client.py

@@ -33,6 +33,13 @@ class VoiceClient:
         request_options: typing.Optional[RequestOptions] = None,
     ) -> typing.Optional[typing.Any]:
         """
+        DEPRECATED: This voice-beta endpoint has been deprecated.
+
+        The voice functionality has been integrated into the main chat completions endpoint.
+        Please use the standard /v1/agents/{agent_id}/messages endpoint instead.
+
+        This endpoint will be removed in a future version.
+
         Parameters
         ----------
         agent_id : str
@@ -89,6 +96,13 @@ class AsyncVoiceClient:
         request_options: typing.Optional[RequestOptions] = None,
     ) -> typing.Optional[typing.Any]:
         """
+        DEPRECATED: This voice-beta endpoint has been deprecated.
+
+        The voice functionality has been integrated into the main chat completions endpoint.
+        Please use the standard /v1/agents/{agent_id}/messages endpoint instead.
+
+        This endpoint will be removed in a future version.
+
         Parameters
         ----------
         agent_id : str

letta_client/voice/raw_client.py

@@ -9,6 +9,7 @@ from ..core.http_response import AsyncHttpResponse, HttpResponse
 from ..core.jsonable_encoder import jsonable_encoder
 from ..core.request_options import RequestOptions
 from ..core.unchecked_base_model import construct_type
+from ..errors.gone_error import GoneError
 from ..errors.unprocessable_entity_error import UnprocessableEntityError
 from ..types.http_validation_error import HttpValidationError
 
@@ -28,6 +29,13 @@ class RawVoiceClient:
         request_options: typing.Optional[RequestOptions] = None,
     ) -> HttpResponse[typing.Optional[typing.Any]]:
         """
+        DEPRECATED: This voice-beta endpoint has been deprecated.
+
+        The voice functionality has been integrated into the main chat completions endpoint.
+        Please use the standard /v1/agents/{agent_id}/messages endpoint instead.
+
+        This endpoint will be removed in a future version.
+
         Parameters
         ----------
         agent_id : str
@@ -64,6 +72,17 @@ class RawVoiceClient:
                     ),
                 )
                 return HttpResponse(response=_response, data=_data)
+            if _response.status_code == 410:
+                raise GoneError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Optional[typing.Any],
+                        construct_type(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
             if _response.status_code == 422:
                 raise UnprocessableEntityError(
                     headers=dict(_response.headers),
@@ -93,6 +112,13 @@ class AsyncRawVoiceClient:
         request_options: typing.Optional[RequestOptions] = None,
     ) -> AsyncHttpResponse[typing.Optional[typing.Any]]:
         """
+        DEPRECATED: This voice-beta endpoint has been deprecated.
+
+        The voice functionality has been integrated into the main chat completions endpoint.
+        Please use the standard /v1/agents/{agent_id}/messages endpoint instead.
+
+        This endpoint will be removed in a future version.
+
         Parameters
         ----------
         agent_id : str
@@ -129,6 +155,17 @@ class AsyncRawVoiceClient:
                     ),
                 )
                 return AsyncHttpResponse(response=_response, data=_data)
+            if _response.status_code == 410:
+                raise GoneError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        typing.Optional[typing.Any],
+                        construct_type(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
             if _response.status_code == 422:
                 raise UnprocessableEntityError(
                     headers=dict(_response.headers),