letta-client 0.1.148__tar.gz → 0.1.150__tar.gz

{letta_client-0.1.148 → letta_client-0.1.150}/PKG-INFO

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

{letta_client-0.1.148 → letta_client-0.1.150}/pyproject.toml

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

{letta_client-0.1.148 → letta_client-0.1.150}/src/letta_client/__init__.py

@@ -21,6 +21,7 @@ from .types import (
     AuthResponse,
     AuthSchemeField,
     BadRequestErrorBody,
+    Base64Image,
     BaseToolRuleSchema,
     BatchJob,
     Block,
@@ -107,6 +108,8 @@ from .types import (
     IdentityPropertyType,
     IdentityPropertyValue,
     IdentityType,
+    ImageContent,
+    ImageContentSource,
     ImageUrl,
     ImageUrlDetail,
     InitToolRule,
@@ -121,6 +124,7 @@ from .types import (
     JsonSchemaResponseFormat,
     LettaBatchMessages,
     LettaBatchRequest,
+    LettaImage,
     LettaMessageContentUnion,
     LettaMessageUnion,
     LettaRequest,
@@ -128,6 +132,7 @@ from .types import (
     LettaResponse,
     LettaStreamingRequest,
     LettaUsageStatistics,
+    LettaUserMessageContentUnion,
     LlmConfig,
     LlmConfigModelEndpointType,
     LlmConfigReasoningEffort,
@@ -219,6 +224,7 @@ from .types import (
     UpdateSystemMessage,
     UpdateUserMessage,
     UpdateUserMessageContent,
+    UrlImage,
     UsageStatistics,
     UsageStatisticsCompletionTokenDetails,
     UsageStatisticsPromptTokenDetails,
@@ -334,6 +340,7 @@ __all__ = [
     "AuthSchemeField",
     "BadRequestError",
     "BadRequestErrorBody",
+    "Base64Image",
     "BaseToolRuleSchema",
     "BatchJob",
     "Block",
@@ -433,6 +440,8 @@ __all__ = [
     "IdentityPropertyType",
     "IdentityPropertyValue",
     "IdentityType",
+    "ImageContent",
+    "ImageContentSource",
     "ImageUrl",
     "ImageUrlDetail",
     "InitToolRule",
@@ -450,6 +459,7 @@ __all__ = [
     "LettaBatchMessages",
     "LettaBatchRequest",
     "LettaEnvironment",
+    "LettaImage",
     "LettaMessageContentUnion",
     "LettaMessageUnion",
     "LettaRequest",
@@ -457,6 +467,7 @@ __all__ = [
     "LettaResponse",
     "LettaStreamingRequest",
     "LettaUsageStatistics",
+    "LettaUserMessageContentUnion",
     "ListMcpServersResponseValue",
     "LlmConfig",
     "LlmConfigModelEndpointType",
@@ -558,6 +569,7 @@ __all__ = [
     "UpdateSystemMessage",
     "UpdateUserMessage",
     "UpdateUserMessageContent",
+    "UrlImage",
     "UsageStatistics",
     "UsageStatisticsCompletionTokenDetails",
     "UsageStatisticsPromptTokenDetails",

{letta_client-0.1.148 → letta_client-0.1.150}/src/letta_client/agents/client.py

@@ -652,7 +652,13 @@ class AgentsClient:
             raise ApiError(status_code=_response.status_code, body=_response.text)
         raise ApiError(status_code=_response.status_code, body=_response_json)
 
-    def retrieve(self, agent_id: str, *, request_options: typing.Optional[RequestOptions] = None) -> AgentState:
+    def retrieve(
+        self,
+        agent_id: str,
+        *,
+        include_relationships: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AgentState:
         """
         Get the state of the agent.
 
@@ -660,6 +666,9 @@ class AgentsClient:
         ----------
         agent_id : str
 
+        include_relationships : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            Specify which relational fields (e.g., 'tools', 'sources', 'memory') to include in the response. If not provided, all relationships are loaded by default. Using this can optimize performance by reducing unnecessary joins.
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -682,6 +691,9 @@ class AgentsClient:
         _response = self._client_wrapper.httpx_client.request(
             f"v1/agents/{jsonable_encoder(agent_id)}",
             method="GET",
+            params={
+                "include_relationships": include_relationships,
+            },
             request_options=request_options,
         )
         try:
@@ -1739,7 +1751,13 @@ class AsyncAgentsClient:
             raise ApiError(status_code=_response.status_code, body=_response.text)
         raise ApiError(status_code=_response.status_code, body=_response_json)
 
-    async def retrieve(self, agent_id: str, *, request_options: typing.Optional[RequestOptions] = None) -> AgentState:
+    async def retrieve(
+        self,
+        agent_id: str,
+        *,
+        include_relationships: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AgentState:
         """
         Get the state of the agent.
 
@@ -1747,6 +1765,9 @@ class AsyncAgentsClient:
         ----------
         agent_id : str
 
+        include_relationships : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            Specify which relational fields (e.g., 'tools', 'sources', 'memory') to include in the response. If not provided, all relationships are loaded by default. Using this can optimize performance by reducing unnecessary joins.
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -1777,6 +1798,9 @@ class AsyncAgentsClient:
         _response = await self._client_wrapper.httpx_client.request(
             f"v1/agents/{jsonable_encoder(agent_id)}",
             method="GET",
+            params={
+                "include_relationships": include_relationships,
+            },
             request_options=request_options,
         )
         try:

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

{letta_client-0.1.148 → letta_client-0.1.150}/src/letta_client/types/__init__.py

@@ -20,6 +20,7 @@ from .auth_request import AuthRequest
 from .auth_response import AuthResponse
 from .auth_scheme_field import AuthSchemeField
 from .bad_request_error_body import BadRequestErrorBody
+from .base_64_image import Base64Image
 from .base_tool_rule_schema import BaseToolRuleSchema
 from .batch_job import BatchJob
 from .block import Block
@@ -106,6 +107,8 @@ from .identity_property import IdentityProperty
 from .identity_property_type import IdentityPropertyType
 from .identity_property_value import IdentityPropertyValue
 from .identity_type import IdentityType
+from .image_content import ImageContent
+from .image_content_source import ImageContentSource
 from .image_url import ImageUrl
 from .image_url_detail import ImageUrlDetail
 from .init_tool_rule import InitToolRule
@@ -120,6 +123,7 @@ from .json_schema import JsonSchema
 from .json_schema_response_format import JsonSchemaResponseFormat
 from .letta_batch_messages import LettaBatchMessages
 from .letta_batch_request import LettaBatchRequest
+from .letta_image import LettaImage
 from .letta_message_content_union import LettaMessageContentUnion
 from .letta_message_union import LettaMessageUnion
 from .letta_request import LettaRequest
@@ -127,6 +131,7 @@ from .letta_request_config import LettaRequestConfig
 from .letta_response import LettaResponse
 from .letta_streaming_request import LettaStreamingRequest
 from .letta_usage_statistics import LettaUsageStatistics
+from .letta_user_message_content_union import LettaUserMessageContentUnion
 from .llm_config import LlmConfig
 from .llm_config_model_endpoint_type import LlmConfigModelEndpointType
 from .llm_config_reasoning_effort import LlmConfigReasoningEffort
@@ -222,6 +227,7 @@ from .update_reasoning_message import UpdateReasoningMessage
 from .update_system_message import UpdateSystemMessage
 from .update_user_message import UpdateUserMessage
 from .update_user_message_content import UpdateUserMessageContent
+from .url_image import UrlImage
 from .usage_statistics import UsageStatistics
 from .usage_statistics_completion_token_details import UsageStatisticsCompletionTokenDetails
 from .usage_statistics_prompt_token_details import UsageStatisticsPromptTokenDetails
@@ -260,6 +266,7 @@ __all__ = [
     "AuthResponse",
     "AuthSchemeField",
     "BadRequestErrorBody",
+    "Base64Image",
     "BaseToolRuleSchema",
     "BatchJob",
     "Block",
@@ -346,6 +353,8 @@ __all__ = [
     "IdentityPropertyType",
     "IdentityPropertyValue",
     "IdentityType",
+    "ImageContent",
+    "ImageContentSource",
     "ImageUrl",
     "ImageUrlDetail",
     "InitToolRule",
@@ -360,6 +369,7 @@ __all__ = [
     "JsonSchemaResponseFormat",
     "LettaBatchMessages",
     "LettaBatchRequest",
+    "LettaImage",
     "LettaMessageContentUnion",
     "LettaMessageUnion",
     "LettaRequest",
@@ -367,6 +377,7 @@ __all__ = [
     "LettaResponse",
     "LettaStreamingRequest",
     "LettaUsageStatistics",
+    "LettaUserMessageContentUnion",
     "LlmConfig",
     "LlmConfigModelEndpointType",
     "LlmConfigReasoningEffort",
@@ -458,6 +469,7 @@ __all__ = [
     "UpdateSystemMessage",
     "UpdateUserMessage",
     "UpdateUserMessageContent",
+    "UrlImage",
     "UsageStatistics",
     "UsageStatisticsCompletionTokenDetails",
     "UsageStatisticsPromptTokenDetails",

letta_client-0.1.150/src/letta_client/types/base_64_image.py

@@ -0,0 +1,33 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.unchecked_base_model import UncheckedBaseModel
+import typing
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+
+
+class Base64Image(UncheckedBaseModel):
+    type: typing.Literal["base64"] = "base64"
+    media_type: str = pydantic.Field()
+    """
+    The media type for the image.
+    """
+
+    data: str = pydantic.Field()
+    """
+    The base64 encoded image data.
+    """
+
+    detail: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    What level of detail to use when processing and understanding the image (low, high, or auto to let the model decide)
+    """
+
+    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.150/src/letta_client/types/image_content.py

@@ -0,0 +1,24 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.unchecked_base_model import UncheckedBaseModel
+import typing
+from .image_content_source import ImageContentSource
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+
+
+class ImageContent(UncheckedBaseModel):
+    type: typing.Literal["image"] = "image"
+    source: ImageContentSource = pydantic.Field()
+    """
+    The source of the image.
+    """
+
+    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.150/src/letta_client/types/image_content_source.py

@@ -0,0 +1,8 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+from .base_64_image import Base64Image
+from .letta_image import LettaImage
+from .url_image import UrlImage
+
+ImageContentSource = typing.Union[Base64Image, LettaImage, UrlImage]

letta_client-0.1.150/src/letta_client/types/letta_image.py

@@ -0,0 +1,38 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.unchecked_base_model import UncheckedBaseModel
+import typing
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+
+
+class LettaImage(UncheckedBaseModel):
+    type: typing.Literal["letta"] = "letta"
+    file_id: str = pydantic.Field()
+    """
+    The unique identifier of the image file persisted in storage.
+    """
+
+    media_type: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The media type for the image.
+    """
+
+    data: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The base64 encoded image data.
+    """
+
+    detail: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    What level of detail to use when processing and understanding the image (low, high, or auto to let the model decide)
+    """
+
+    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.148 → letta_client-0.1.150}/src/letta_client/types/letta_message_content_union.py

@@ -2,11 +2,12 @@
 
 import typing
 from .text_content import TextContent
+from .image_content import ImageContent
 from .tool_call_content import ToolCallContent
 from .reasoning_content import ReasoningContent
 from .redacted_reasoning_content import RedactedReasoningContent
 from .omitted_reasoning_content import OmittedReasoningContent
 
 LettaMessageContentUnion = typing.Union[
-    TextContent, ToolCallContent, ReasoningContent, RedactedReasoningContent, OmittedReasoningContent
+    TextContent, ImageContent, ToolCallContent, ReasoningContent, RedactedReasoningContent, OmittedReasoningContent
 ]

letta_client-0.1.150/src/letta_client/types/letta_user_message_content_union.py

@@ -0,0 +1,7 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+from .text_content import TextContent
+from .image_content import ImageContent
+
+LettaUserMessageContentUnion = typing.Union[TextContent, ImageContent]

{letta_client-0.1.148 → letta_client-0.1.150}/src/letta_client/types/message_content_item.py

@@ -1,6 +1,7 @@
 # This file was auto-generated by Fern from our API Definition.
 
 import typing
+from .image_content import ImageContent
 from .omitted_reasoning_content import OmittedReasoningContent
 from .reasoning_content import ReasoningContent
 from .redacted_reasoning_content import RedactedReasoningContent
@@ -9,5 +10,11 @@ from .tool_call_content import ToolCallContent
 from .tool_return_content import ToolReturnContent
 
 MessageContentItem = typing.Union[
-    OmittedReasoningContent, ReasoningContent, RedactedReasoningContent, TextContent, ToolCallContent, ToolReturnContent
+    ImageContent,
+    OmittedReasoningContent,
+    ReasoningContent,
+    RedactedReasoningContent,
+    TextContent,
+    ToolCallContent,
+    ToolReturnContent,
 ]

letta_client-0.1.150/src/letta_client/types/update_user_message_content.py

@@ -0,0 +1,6 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+from .letta_user_message_content_union import LettaUserMessageContentUnion
+
+UpdateUserMessageContent = typing.Union[typing.List[LettaUserMessageContentUnion], str]

letta_client-0.1.150/src/letta_client/types/url_image.py

@@ -0,0 +1,23 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.unchecked_base_model import UncheckedBaseModel
+import typing
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+
+
+class UrlImage(UncheckedBaseModel):
+    type: typing.Literal["url"] = "url"
+    url: str = pydantic.Field()
+    """
+    The URL of the image.
+    """
+
+    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.150/src/letta_client/types/user_message_content.py

@@ -0,0 +1,6 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+from .letta_user_message_content_union import LettaUserMessageContentUnion
+
+UserMessageContent = typing.Union[typing.List[LettaUserMessageContentUnion], str]

letta_client-0.1.148/src/letta_client/types/update_user_message_content.py

@@ -1,6 +0,0 @@
-# This file was auto-generated by Fern from our API Definition.
-
-import typing
-from .components_schemas_text_content import ComponentsSchemasTextContent
-
-UpdateUserMessageContent = typing.Union[typing.List[ComponentsSchemasTextContent], str]

letta_client-0.1.148/src/letta_client/types/user_message_content.py

@@ -1,6 +0,0 @@
-# This file was auto-generated by Fern from our API Definition.
-
-import typing
-from .components_schemas_text_content import ComponentsSchemasTextContent
-
-UserMessageContent = typing.Union[typing.List[ComponentsSchemasTextContent], str]