letta-client 0.1.13__tar.gz → 0.1.15__tar.gz

{letta_client-0.1.13 → letta_client-0.1.15}/PKG-INFO

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

{letta_client-0.1.13 → letta_client-0.1.15}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "letta-client"
-version = "0.1.13"
+version = "0.1.15"
 description = ""
 readme = "README.md"
 authors = []

{letta_client-0.1.13 → letta_client-0.1.15}/src/letta_client/__init__.py

@@ -51,6 +51,7 @@ from .types import (
     JobStatus,
     JobType,
     LettaRequest,
+    LettaRequestConfig,
     LettaResponse,
     LettaResponseMessagesItem,
     LettaResponseMessagesItem_AssistantMessage,
@@ -147,6 +148,15 @@ from .agents import (
 )
 from .client import AsyncLetta, Letta
 from .environment import LettaEnvironment
+from .runs import (
+    GetRunMessagesResponseItem,
+    GetRunMessagesResponseItem_AssistantMessage,
+    GetRunMessagesResponseItem_ReasoningMessage,
+    GetRunMessagesResponseItem_SystemMessage,
+    GetRunMessagesResponseItem_ToolCallMessage,
+    GetRunMessagesResponseItem_ToolReturnMessage,
+    GetRunMessagesResponseItem_UserMessage,
+)
 from .version import __version__
 
 __all__ = [
@@ -208,6 +218,13 @@ __all__ = [
     "FunctionCallInput",
     "FunctionCallOutput",
     "FunctionSchema",
+    "GetRunMessagesResponseItem",
+    "GetRunMessagesResponseItem_AssistantMessage",
+    "GetRunMessagesResponseItem_ReasoningMessage",
+    "GetRunMessagesResponseItem_SystemMessage",
+    "GetRunMessagesResponseItem_ToolCallMessage",
+    "GetRunMessagesResponseItem_ToolReturnMessage",
+    "GetRunMessagesResponseItem_UserMessage",
     "Health",
     "HttpValidationError",
     "InitToolRule",
@@ -219,6 +236,7 @@ __all__ = [
     "Letta",
     "LettaEnvironment",
     "LettaRequest",
+    "LettaRequestConfig",
     "LettaResponse",
     "LettaResponseMessagesItem",
     "LettaResponseMessagesItem_AssistantMessage",

{letta_client-0.1.13 → letta_client-0.1.15}/src/letta_client/agents/client.py

@@ -63,8 +63,9 @@ class AgentsClient:
         name: typing.Optional[str] = None,
         tags: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
         match_all_tags: typing.Optional[bool] = None,
-        cursor: typing.Optional[int] = None,
+        cursor: typing.Optional[str] = None,
         limit: typing.Optional[int] = None,
+        query_text: typing.Optional[str] = None,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> typing.List[AgentState]:
         """
@@ -82,12 +83,15 @@ class AgentsClient:
         match_all_tags : typing.Optional[bool]
             If True, only returns agents that match ALL given tags. Otherwise, return agents that have ANY of the passed in tags.
 
-        cursor : typing.Optional[int]
+        cursor : typing.Optional[str]
             Cursor for pagination
 
         limit : typing.Optional[int]
             Limit for pagination
 
+        query_text : typing.Optional[str]
+            Search agents by name
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -114,6 +118,7 @@ class AgentsClient:
                 "match_all_tags": match_all_tags,
                 "cursor": cursor,
                 "limit": limit,
+                "query_text": query_text,
             },
             request_options=request_options,
         )
@@ -747,8 +752,9 @@ class AsyncAgentsClient:
         name: typing.Optional[str] = None,
         tags: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
         match_all_tags: typing.Optional[bool] = None,
-        cursor: typing.Optional[int] = None,
+        cursor: typing.Optional[str] = None,
         limit: typing.Optional[int] = None,
+        query_text: typing.Optional[str] = None,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> typing.List[AgentState]:
         """
@@ -766,12 +772,15 @@ class AsyncAgentsClient:
         match_all_tags : typing.Optional[bool]
             If True, only returns agents that match ALL given tags. Otherwise, return agents that have ANY of the passed in tags.
 
-        cursor : typing.Optional[int]
+        cursor : typing.Optional[str]
             Cursor for pagination
 
         limit : typing.Optional[int]
             Limit for pagination
 
+        query_text : typing.Optional[str]
+            Search agents by name
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -806,6 +815,7 @@ class AsyncAgentsClient:
                 "match_all_tags": match_all_tags,
                 "cursor": cursor,
                 "limit": limit,
+                "query_text": query_text,
             },
             request_options=request_options,
         )

{letta_client-0.1.13 → letta_client-0.1.15}/src/letta_client/agents/messages/client.py

@@ -11,6 +11,7 @@ from ...types.http_validation_error import HttpValidationError
 from json.decoder import JSONDecodeError
 from ...core.api_error import ApiError
 from ...types.message_create import MessageCreate
+from ...types.letta_request_config import LettaRequestConfig
 from ...types.letta_response import LettaResponse
 from ...core.serialization import convert_and_respect_annotation_metadata
 from ...types.message_role import MessageRole
@@ -125,9 +126,7 @@ class MessagesClient:
         agent_id: str,
         *,
         messages: typing.Sequence[MessageCreate],
-        use_assistant_message: typing.Optional[bool] = OMIT,
-        assistant_message_tool_name: typing.Optional[str] = OMIT,
-        assistant_message_tool_kwarg: typing.Optional[str] = OMIT,
+        config: typing.Optional[LettaRequestConfig] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> LettaResponse:
         """
@@ -141,14 +140,8 @@ class MessagesClient:
         messages : typing.Sequence[MessageCreate]
             The messages to be sent to the agent.
 
-        use_assistant_message : typing.Optional[bool]
-            Whether the server should parse specific tool call arguments (default `send_message`) as `AssistantMessage` objects.
-
-        assistant_message_tool_name : typing.Optional[str]
-            The name of the designated message tool.
-
-        assistant_message_tool_kwarg : typing.Optional[str]
-            The name of the message argument in the designated message tool.
+        config : typing.Optional[LettaRequestConfig]
+            Configuration options for the LettaRequest.
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -182,9 +175,9 @@ class MessagesClient:
                 "messages": convert_and_respect_annotation_metadata(
                     object_=messages, annotation=typing.Sequence[MessageCreate], direction="write"
                 ),
-                "use_assistant_message": use_assistant_message,
-                "assistant_message_tool_name": assistant_message_tool_name,
-                "assistant_message_tool_kwarg": assistant_message_tool_kwarg,
+                "config": convert_and_respect_annotation_metadata(
+                    object_=config, annotation=LettaRequestConfig, direction="write"
+                ),
             },
             request_options=request_options,
             omit=OMIT,
@@ -318,9 +311,7 @@ class MessagesClient:
         agent_id: str,
         *,
         messages: typing.Sequence[MessageCreate],
-        use_assistant_message: typing.Optional[bool] = OMIT,
-        assistant_message_tool_name: typing.Optional[str] = OMIT,
-        assistant_message_tool_kwarg: typing.Optional[str] = OMIT,
+        config: typing.Optional[LettaRequestConfig] = OMIT,
         stream_tokens: typing.Optional[bool] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> typing.Iterator[LettaStreamingResponse]:
@@ -336,14 +327,8 @@ class MessagesClient:
         messages : typing.Sequence[MessageCreate]
             The messages to be sent to the agent.
 
-        use_assistant_message : typing.Optional[bool]
-            Whether the server should parse specific tool call arguments (default `send_message`) as `AssistantMessage` objects.
-
-        assistant_message_tool_name : typing.Optional[str]
-            The name of the designated message tool.
-
-        assistant_message_tool_kwarg : typing.Optional[str]
-            The name of the message argument in the designated message tool.
+        config : typing.Optional[LettaRequestConfig]
+            Configuration options for the LettaRequest.
 
         stream_tokens : typing.Optional[bool]
             Flag to determine if individual tokens should be streamed. Set to True for token streaming (requires stream_steps = True).
@@ -382,9 +367,9 @@ class MessagesClient:
                 "messages": convert_and_respect_annotation_metadata(
                     object_=messages, annotation=typing.Sequence[MessageCreate], direction="write"
                 ),
-                "use_assistant_message": use_assistant_message,
-                "assistant_message_tool_name": assistant_message_tool_name,
-                "assistant_message_tool_kwarg": assistant_message_tool_kwarg,
+                "config": convert_and_respect_annotation_metadata(
+                    object_=config, annotation=LettaRequestConfig, direction="write"
+                ),
                 "stream_tokens": stream_tokens,
             },
             headers={
@@ -429,14 +414,12 @@ class MessagesClient:
         agent_id: str,
         *,
         messages: typing.Sequence[MessageCreate],
-        use_assistant_message: typing.Optional[bool] = OMIT,
-        assistant_message_tool_name: typing.Optional[str] = OMIT,
-        assistant_message_tool_kwarg: typing.Optional[str] = OMIT,
+        config: typing.Optional[LettaRequestConfig] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> Run:
         """
-        Asynchronously process a user message and return a job ID.
-        The actual processing happens in the background, and the status can be checked using the job ID.
+        Asynchronously process a user message and return a run object.
+        The actual processing happens in the background, and the status can be checked using the run ID.
 
         Parameters
         ----------
@@ -445,14 +428,8 @@ class MessagesClient:
         messages : typing.Sequence[MessageCreate]
             The messages to be sent to the agent.
 
-        use_assistant_message : typing.Optional[bool]
-            Whether the server should parse specific tool call arguments (default `send_message`) as `AssistantMessage` objects.
-
-        assistant_message_tool_name : typing.Optional[str]
-            The name of the designated message tool.
-
-        assistant_message_tool_kwarg : typing.Optional[str]
-            The name of the message argument in the designated message tool.
+        config : typing.Optional[LettaRequestConfig]
+            Configuration options for the LettaRequest.
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -486,9 +463,9 @@ class MessagesClient:
                 "messages": convert_and_respect_annotation_metadata(
                     object_=messages, annotation=typing.Sequence[MessageCreate], direction="write"
                 ),
-                "use_assistant_message": use_assistant_message,
-                "assistant_message_tool_name": assistant_message_tool_name,
-                "assistant_message_tool_kwarg": assistant_message_tool_kwarg,
+                "config": convert_and_respect_annotation_metadata(
+                    object_=config, annotation=LettaRequestConfig, direction="write"
+                ),
             },
             request_options=request_options,
             omit=OMIT,
@@ -623,9 +600,7 @@ class AsyncMessagesClient:
         agent_id: str,
         *,
         messages: typing.Sequence[MessageCreate],
-        use_assistant_message: typing.Optional[bool] = OMIT,
-        assistant_message_tool_name: typing.Optional[str] = OMIT,
-        assistant_message_tool_kwarg: typing.Optional[str] = OMIT,
+        config: typing.Optional[LettaRequestConfig] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> LettaResponse:
         """
@@ -639,14 +614,8 @@ class AsyncMessagesClient:
         messages : typing.Sequence[MessageCreate]
             The messages to be sent to the agent.
 
-        use_assistant_message : typing.Optional[bool]
-            Whether the server should parse specific tool call arguments (default `send_message`) as `AssistantMessage` objects.
-
-        assistant_message_tool_name : typing.Optional[str]
-            The name of the designated message tool.
-
-        assistant_message_tool_kwarg : typing.Optional[str]
-            The name of the message argument in the designated message tool.
+        config : typing.Optional[LettaRequestConfig]
+            Configuration options for the LettaRequest.
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -688,9 +657,9 @@ class AsyncMessagesClient:
                 "messages": convert_and_respect_annotation_metadata(
                     object_=messages, annotation=typing.Sequence[MessageCreate], direction="write"
                 ),
-                "use_assistant_message": use_assistant_message,
-                "assistant_message_tool_name": assistant_message_tool_name,
-                "assistant_message_tool_kwarg": assistant_message_tool_kwarg,
+                "config": convert_and_respect_annotation_metadata(
+                    object_=config, annotation=LettaRequestConfig, direction="write"
+                ),
             },
             request_options=request_options,
             omit=OMIT,
@@ -832,9 +801,7 @@ class AsyncMessagesClient:
         agent_id: str,
         *,
         messages: typing.Sequence[MessageCreate],
-        use_assistant_message: typing.Optional[bool] = OMIT,
-        assistant_message_tool_name: typing.Optional[str] = OMIT,
-        assistant_message_tool_kwarg: typing.Optional[str] = OMIT,
+        config: typing.Optional[LettaRequestConfig] = OMIT,
         stream_tokens: typing.Optional[bool] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> typing.AsyncIterator[LettaStreamingResponse]:
@@ -850,14 +817,8 @@ class AsyncMessagesClient:
         messages : typing.Sequence[MessageCreate]
             The messages to be sent to the agent.
 
-        use_assistant_message : typing.Optional[bool]
-            Whether the server should parse specific tool call arguments (default `send_message`) as `AssistantMessage` objects.
-
-        assistant_message_tool_name : typing.Optional[str]
-            The name of the designated message tool.
-
-        assistant_message_tool_kwarg : typing.Optional[str]
-            The name of the message argument in the designated message tool.
+        config : typing.Optional[LettaRequestConfig]
+            Configuration options for the LettaRequest.
 
         stream_tokens : typing.Optional[bool]
             Flag to determine if individual tokens should be streamed. Set to True for token streaming (requires stream_steps = True).
@@ -904,9 +865,9 @@ class AsyncMessagesClient:
                 "messages": convert_and_respect_annotation_metadata(
                     object_=messages, annotation=typing.Sequence[MessageCreate], direction="write"
                 ),
-                "use_assistant_message": use_assistant_message,
-                "assistant_message_tool_name": assistant_message_tool_name,
-                "assistant_message_tool_kwarg": assistant_message_tool_kwarg,
+                "config": convert_and_respect_annotation_metadata(
+                    object_=config, annotation=LettaRequestConfig, direction="write"
+                ),
                 "stream_tokens": stream_tokens,
             },
             headers={
@@ -951,14 +912,12 @@ class AsyncMessagesClient:
         agent_id: str,
         *,
         messages: typing.Sequence[MessageCreate],
-        use_assistant_message: typing.Optional[bool] = OMIT,
-        assistant_message_tool_name: typing.Optional[str] = OMIT,
-        assistant_message_tool_kwarg: typing.Optional[str] = OMIT,
+        config: typing.Optional[LettaRequestConfig] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> Run:
         """
-        Asynchronously process a user message and return a job ID.
-        The actual processing happens in the background, and the status can be checked using the job ID.
+        Asynchronously process a user message and return a run object.
+        The actual processing happens in the background, and the status can be checked using the run ID.
 
         Parameters
         ----------
@@ -967,14 +926,8 @@ class AsyncMessagesClient:
         messages : typing.Sequence[MessageCreate]
             The messages to be sent to the agent.
 
-        use_assistant_message : typing.Optional[bool]
-            Whether the server should parse specific tool call arguments (default `send_message`) as `AssistantMessage` objects.
-
-        assistant_message_tool_name : typing.Optional[str]
-            The name of the designated message tool.
-
-        assistant_message_tool_kwarg : typing.Optional[str]
-            The name of the message argument in the designated message tool.
+        config : typing.Optional[LettaRequestConfig]
+            Configuration options for the LettaRequest.
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -1016,9 +969,9 @@ class AsyncMessagesClient:
                 "messages": convert_and_respect_annotation_metadata(
                     object_=messages, annotation=typing.Sequence[MessageCreate], direction="write"
                 ),
-                "use_assistant_message": use_assistant_message,
-                "assistant_message_tool_name": assistant_message_tool_name,
-                "assistant_message_tool_kwarg": assistant_message_tool_kwarg,
+                "config": convert_and_respect_annotation_metadata(
+                    object_=config, annotation=LettaRequestConfig, direction="write"
+                ),
             },
             request_options=request_options,
             omit=OMIT,

{letta_client-0.1.13 → letta_client-0.1.15}/src/letta_client/client.py

@@ -1,13 +1,12 @@
-from textwrap import dedent
 import inspect
 import typing
+from textwrap import dedent
 
-from .base_client import LettaBase, AsyncLettaBase
+from .base_client import AsyncLettaBase, LettaBase
 from .core.request_options import RequestOptions
 from .tools.client import ToolsClient as ToolsClientBase
 from .types.letta_schemas_tool_tool import LettaSchemasToolTool
 
-
 # this is used as the default value for optional parameters
 OMIT = typing.cast(typing.Any, ...)
 
@@ -16,14 +15,14 @@ class Letta(LettaBase):
 
     def __init__(self, *args, **kwargs):
         super().__init__(*args, **kwargs)
-        self.tools = ExtendedToolsClient(client_wrapper=self._client_wrapper)
+        self.tools = ToolsClient(client_wrapper=self._client_wrapper)
 
 
 class AsyncLetta(AsyncLettaBase):
 
     def __init__(self, *args, **kwargs):
         super().__init__(*args, **kwargs)
-        self.tools = ExtendedToolsClient(client_wrapper=self._client_wrapper)
+        self.tools = ToolsClient(client_wrapper=self._client_wrapper)
 
 
 class ToolsClient(ToolsClientBase):
@@ -31,7 +30,7 @@ class ToolsClient(ToolsClientBase):
     def create_from_function(
         self,
         *,
-        function: typing.Callable,
+        func: typing.Callable,
         name: typing.Optional[str] = OMIT,
         description: typing.Optional[str] = OMIT,
         tags: typing.Optional[typing.Sequence[str]] = OMIT,
@@ -42,7 +41,7 @@ class ToolsClient(ToolsClientBase):
         return_char_limit: typing.Optional[int] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> LettaSchemasToolTool:
-        source_code = dedent(inspect.getsource(function))
+        source_code = dedent(inspect.getsource(func))
         return self.create(
             source_code=source_code,
             name=name,
@@ -53,3 +52,29 @@ class ToolsClient(ToolsClientBase):
             return_char_limit=return_char_limit,
             request_options=request_options,
         )
+
+    def upsert_from_function(
+        self,
+        *,
+        func: typing.Callable,
+        name: typing.Optional[str] = OMIT,
+        description: typing.Optional[str] = OMIT,
+        tags: typing.Optional[typing.Sequence[str]] = OMIT,
+        source_type: typing.Optional[str] = OMIT,
+        json_schema: typing.Optional[
+            typing.Dict[str, typing.Optional[typing.Any]]
+        ] = OMIT,
+        return_char_limit: typing.Optional[int] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> LettaSchemasToolTool:
+        source_code = dedent(inspect.getsource(func))
+        return self.upsert(
+            source_code=source_code,
+            name=name,
+            description=description,
+            tags=tags,
+            source_type=source_type,
+            json_schema=json_schema,
+            return_char_limit=return_char_limit,
+            request_options=request_options,
+        )

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

letta_client-0.1.15/src/letta_client/runs/__init__.py

@@ -0,0 +1,21 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from .types import (
+    GetRunMessagesResponseItem,
+    GetRunMessagesResponseItem_AssistantMessage,
+    GetRunMessagesResponseItem_ReasoningMessage,
+    GetRunMessagesResponseItem_SystemMessage,
+    GetRunMessagesResponseItem_ToolCallMessage,
+    GetRunMessagesResponseItem_ToolReturnMessage,
+    GetRunMessagesResponseItem_UserMessage,
+)
+
+__all__ = [
+    "GetRunMessagesResponseItem",
+    "GetRunMessagesResponseItem_AssistantMessage",
+    "GetRunMessagesResponseItem_ReasoningMessage",
+    "GetRunMessagesResponseItem_SystemMessage",
+    "GetRunMessagesResponseItem_ToolCallMessage",
+    "GetRunMessagesResponseItem_ToolReturnMessage",
+    "GetRunMessagesResponseItem_UserMessage",
+]