letta-client 0.1.174__tar.gz → 0.1.176__tar.gz

{letta_client-0.1.174 → letta_client-0.1.176}/PKG-INFO

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

{letta_client-0.1.174 → letta_client-0.1.176}/pyproject.toml

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

{letta_client-0.1.174 → letta_client-0.1.176}/src/letta_client/__init__.py

@@ -198,6 +198,7 @@ from .types import (
     SseServerConfig,
     StdioServerConfig,
     Step,
+    StepFeedback,
     StopReasonType,
     StreamableHttpServerConfig,
     SupervisorManager,
@@ -307,12 +308,14 @@ from .client_side_access_tokens import (
 from .environment import LettaEnvironment
 from .groups import GroupCreateManagerConfig, GroupUpdateManagerConfig
 from .projects import ProjectsListResponse, ProjectsListResponseProjectsItem
+from .steps import AddFeedbackRequestFeedback, StepsListRequestFeedback
 from .templates import TemplatesListResponse, TemplatesListResponseTemplatesItem
 from .tools import (
     AddMcpServerRequest,
     AddMcpServerResponseItem,
     DeleteMcpServerResponseItem,
     ListMcpServersResponseValue,
+    TestMcpServerRequest,
     UpdateMcpServerRequest,
     UpdateMcpServerResponse,
 )
@@ -322,6 +325,7 @@ __all__ = [
     "ActionModel",
     "ActionParametersModel",
     "ActionResponseModel",
+    "AddFeedbackRequestFeedback",
     "AddMcpServerRequest",
     "AddMcpServerResponseItem",
     "AgentEnvironmentVariable",
@@ -548,6 +552,8 @@ __all__ = [
     "SseServerConfig",
     "StdioServerConfig",
     "Step",
+    "StepFeedback",
+    "StepsListRequestFeedback",
     "StopReasonType",
     "StreamableHttpServerConfig",
     "SupervisorManager",
@@ -557,6 +563,7 @@ __all__ = [
     "TemplatesListResponse",
     "TemplatesListResponseTemplatesItem",
     "TerminalToolRule",
+    "TestMcpServerRequest",
     "TextContent",
     "TextResponseFormat",
     "Tool",

{letta_client-0.1.174 → letta_client-0.1.176}/src/letta_client/agents/client.py

@@ -221,6 +221,7 @@ class AgentsClient:
         include_base_tools: typing.Optional[bool] = OMIT,
         include_multi_agent_tools: typing.Optional[bool] = OMIT,
         include_base_tool_rules: typing.Optional[bool] = OMIT,
+        include_default_source: typing.Optional[bool] = OMIT,
         description: typing.Optional[str] = OMIT,
         metadata: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
         model: typing.Optional[str] = OMIT,
@@ -300,6 +301,9 @@ class AgentsClient:
         include_base_tool_rules : typing.Optional[bool]
             If true, attaches the Letta base tool rules (e.g. deny all tools not explicitly allowed).
 
+        include_default_source : typing.Optional[bool]
+            If true, automatically creates and attaches a default data source for this agent.
+
         description : typing.Optional[str]
             The description of the agent.
 
@@ -413,6 +417,7 @@ class AgentsClient:
                 "include_base_tools": include_base_tools,
                 "include_multi_agent_tools": include_multi_agent_tools,
                 "include_base_tool_rules": include_base_tool_rules,
+                "include_default_source": include_default_source,
                 "description": description,
                 "metadata": metadata,
                 "model": model,
@@ -1321,6 +1326,7 @@ class AsyncAgentsClient:
         include_base_tools: typing.Optional[bool] = OMIT,
         include_multi_agent_tools: typing.Optional[bool] = OMIT,
         include_base_tool_rules: typing.Optional[bool] = OMIT,
+        include_default_source: typing.Optional[bool] = OMIT,
         description: typing.Optional[str] = OMIT,
         metadata: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = OMIT,
         model: typing.Optional[str] = OMIT,
@@ -1400,6 +1406,9 @@ class AsyncAgentsClient:
         include_base_tool_rules : typing.Optional[bool]
             If true, attaches the Letta base tool rules (e.g. deny all tools not explicitly allowed).
 
+        include_default_source : typing.Optional[bool]
+            If true, automatically creates and attaches a default data source for this agent.
+
         description : typing.Optional[str]
             The description of the agent.
 
@@ -1521,6 +1530,7 @@ class AsyncAgentsClient:
                 "include_base_tools": include_base_tools,
                 "include_multi_agent_tools": include_multi_agent_tools,
                 "include_base_tool_rules": include_base_tool_rules,
+                "include_default_source": include_default_source,
                 "description": description,
                 "metadata": metadata,
                 "model": model,

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

letta_client-0.1.176/src/letta_client/steps/__init__.py

@@ -0,0 +1,6 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from .types import AddFeedbackRequestFeedback, StepsListRequestFeedback
+from . import feedback
+
+__all__ = ["AddFeedbackRequestFeedback", "StepsListRequestFeedback", "feedback"]

{letta_client-0.1.174 → letta_client-0.1.176}/src/letta_client/steps/client.py

@@ -1,7 +1,9 @@
 # This file was auto-generated by Fern from our API Definition.
 
 from ..core.client_wrapper import SyncClientWrapper
+from .feedback.client import FeedbackClient
 import typing
+from .types.steps_list_request_feedback import StepsListRequestFeedback
 from ..core.request_options import RequestOptions
 from ..types.step import Step
 from ..core.unchecked_base_model import construct_type
@@ -10,12 +12,15 @@ from ..types.http_validation_error import HttpValidationError
 from json.decoder import JSONDecodeError
 from ..core.api_error import ApiError
 from ..core.jsonable_encoder import jsonable_encoder
+from .types.add_feedback_request_feedback import AddFeedbackRequestFeedback
 from ..core.client_wrapper import AsyncClientWrapper
+from .feedback.client import AsyncFeedbackClient
 
 
 class StepsClient:
     def __init__(self, *, client_wrapper: SyncClientWrapper):
         self._client_wrapper = client_wrapper
+        self.feedback = FeedbackClient(client_wrapper=self._client_wrapper)
 
     def list(
         self,
@@ -29,6 +34,8 @@ class StepsClient:
         model: typing.Optional[str] = None,
         agent_id: typing.Optional[str] = None,
         trace_ids: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        feedback: typing.Optional[StepsListRequestFeedback] = None,
+        tags: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> typing.List[Step]:
         """
@@ -64,6 +71,12 @@ class StepsClient:
         trace_ids : typing.Optional[typing.Union[str, typing.Sequence[str]]]
             Filter by trace ids returned by the server
 
+        feedback : typing.Optional[StepsListRequestFeedback]
+            Filter by feedback
+
+        tags : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            Filter by tags
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -94,6 +107,8 @@ class StepsClient:
                 "model": model,
                 "agent_id": agent_id,
                 "trace_ids": trace_ids,
+                "feedback": feedback,
+                "tags": tags,
             },
             request_options=request_options,
         )
@@ -177,10 +192,78 @@ class StepsClient:
             raise ApiError(status_code=_response.status_code, body=_response.text)
         raise ApiError(status_code=_response.status_code, body=_response_json)
 
+    def add_feedback(
+        self,
+        step_id: str,
+        *,
+        feedback: typing.Optional[AddFeedbackRequestFeedback] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> Step:
+        """
+        Add feedback to a step.
+
+        Parameters
+        ----------
+        step_id : str
+
+        feedback : typing.Optional[AddFeedbackRequestFeedback]
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        Step
+            Successful Response
+
+        Examples
+        --------
+        from letta_client import Letta
+
+        client = Letta(
+            token="YOUR_TOKEN",
+        )
+        client.steps.add_feedback(
+            step_id="step_id",
+        )
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            f"v1/steps/{jsonable_encoder(step_id)}/feedback",
+            method="PATCH",
+            params={
+                "feedback": feedback,
+            },
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    Step,
+                    construct_type(
+                        type_=Step,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            if _response.status_code == 422:
+                raise UnprocessableEntityError(
+                    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, body=_response.text)
+        raise ApiError(status_code=_response.status_code, body=_response_json)
+
 
 class AsyncStepsClient:
     def __init__(self, *, client_wrapper: AsyncClientWrapper):
         self._client_wrapper = client_wrapper
+        self.feedback = AsyncFeedbackClient(client_wrapper=self._client_wrapper)
 
     async def list(
         self,
@@ -194,6 +277,8 @@ class AsyncStepsClient:
         model: typing.Optional[str] = None,
         agent_id: typing.Optional[str] = None,
         trace_ids: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        feedback: typing.Optional[StepsListRequestFeedback] = None,
+        tags: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> typing.List[Step]:
         """
@@ -229,6 +314,12 @@ class AsyncStepsClient:
         trace_ids : typing.Optional[typing.Union[str, typing.Sequence[str]]]
             Filter by trace ids returned by the server
 
+        feedback : typing.Optional[StepsListRequestFeedback]
+            Filter by feedback
+
+        tags : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            Filter by tags
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -267,6 +358,8 @@ class AsyncStepsClient:
                 "model": model,
                 "agent_id": agent_id,
                 "trace_ids": trace_ids,
+                "feedback": feedback,
+                "tags": tags,
             },
             request_options=request_options,
         )
@@ -357,3 +450,78 @@ class AsyncStepsClient:
         except JSONDecodeError:
             raise ApiError(status_code=_response.status_code, body=_response.text)
         raise ApiError(status_code=_response.status_code, body=_response_json)
+
+    async def add_feedback(
+        self,
+        step_id: str,
+        *,
+        feedback: typing.Optional[AddFeedbackRequestFeedback] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> Step:
+        """
+        Add feedback to a step.
+
+        Parameters
+        ----------
+        step_id : str
+
+        feedback : typing.Optional[AddFeedbackRequestFeedback]
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        Step
+            Successful Response
+
+        Examples
+        --------
+        import asyncio
+
+        from letta_client import AsyncLetta
+
+        client = AsyncLetta(
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.steps.add_feedback(
+                step_id="step_id",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            f"v1/steps/{jsonable_encoder(step_id)}/feedback",
+            method="PATCH",
+            params={
+                "feedback": feedback,
+            },
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    Step,
+                    construct_type(
+                        type_=Step,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            if _response.status_code == 422:
+                raise UnprocessableEntityError(
+                    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, body=_response.text)
+        raise ApiError(status_code=_response.status_code, body=_response_json)

letta_client-0.1.176/src/letta_client/steps/feedback/client.py

@@ -0,0 +1,101 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ...core.client_wrapper import SyncClientWrapper
+import typing
+from ...core.request_options import RequestOptions
+from ...core.jsonable_encoder import jsonable_encoder
+from json.decoder import JSONDecodeError
+from ...core.api_error import ApiError
+from ...core.client_wrapper import AsyncClientWrapper
+
+
+class FeedbackClient:
+    def __init__(self, *, client_wrapper: SyncClientWrapper):
+        self._client_wrapper = client_wrapper
+
+    def add(self, step_id: str, *, request_options: typing.Optional[RequestOptions] = None) -> None:
+        """
+        Parameters
+        ----------
+        step_id : str
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        None
+
+        Examples
+        --------
+        from letta_client import Letta
+
+        client = Letta(
+            token="YOUR_TOKEN",
+        )
+        client.steps.feedback.add(
+            step_id="step_id",
+        )
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            f"v1/steps/{jsonable_encoder(step_id)}/feedback",
+            method="POST",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, body=_response.text)
+        raise ApiError(status_code=_response.status_code, body=_response_json)
+
+
+class AsyncFeedbackClient:
+    def __init__(self, *, client_wrapper: AsyncClientWrapper):
+        self._client_wrapper = client_wrapper
+
+    async def add(self, step_id: str, *, request_options: typing.Optional[RequestOptions] = None) -> None:
+        """
+        Parameters
+        ----------
+        step_id : str
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        None
+
+        Examples
+        --------
+        import asyncio
+
+        from letta_client import AsyncLetta
+
+        client = AsyncLetta(
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.steps.feedback.add(
+                step_id="step_id",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            f"v1/steps/{jsonable_encoder(step_id)}/feedback",
+            method="POST",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, body=_response.text)
+        raise ApiError(status_code=_response.status_code, body=_response_json)

letta_client-0.1.176/src/letta_client/steps/types/__init__.py

@@ -0,0 +1,6 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from .add_feedback_request_feedback import AddFeedbackRequestFeedback
+from .steps_list_request_feedback import StepsListRequestFeedback
+
+__all__ = ["AddFeedbackRequestFeedback", "StepsListRequestFeedback"]

letta_client-0.1.176/src/letta_client/steps/types/add_feedback_request_feedback.py

@@ -0,0 +1,5 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+AddFeedbackRequestFeedback = typing.Union[typing.Literal["positive", "negative"], typing.Any]

letta_client-0.1.176/src/letta_client/steps/types/steps_list_request_feedback.py

@@ -0,0 +1,5 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+StepsListRequestFeedback = typing.Union[typing.Literal["positive", "negative"], typing.Any]

{letta_client-0.1.174 → letta_client-0.1.176}/src/letta_client/tools/__init__.py

@@ -5,6 +5,7 @@ from .types import (
     AddMcpServerResponseItem,
     DeleteMcpServerResponseItem,
     ListMcpServersResponseValue,
+    TestMcpServerRequest,
     UpdateMcpServerRequest,
     UpdateMcpServerResponse,
 )
@@ -14,6 +15,7 @@ __all__ = [
     "AddMcpServerResponseItem",
     "DeleteMcpServerResponseItem",
     "ListMcpServersResponseValue",
+    "TestMcpServerRequest",
     "UpdateMcpServerRequest",
     "UpdateMcpServerResponse",
 ]

{letta_client-0.1.174 → letta_client-0.1.176}/src/letta_client/tools/client.py

@@ -22,6 +22,7 @@ from ..types.mcp_tool import McpTool
 from .types.delete_mcp_server_response_item import DeleteMcpServerResponseItem
 from .types.update_mcp_server_request import UpdateMcpServerRequest
 from .types.update_mcp_server_response import UpdateMcpServerResponse
+from .types.test_mcp_server_request import TestMcpServerRequest
 from ..core.client_wrapper import AsyncClientWrapper
 
 # this is used as the default value for optional parameters
@@ -1299,6 +1300,73 @@ class ToolsClient:
             raise ApiError(status_code=_response.status_code, body=_response.text)
         raise ApiError(status_code=_response.status_code, body=_response_json)
 
+    def test_mcp_server(
+        self, *, request: TestMcpServerRequest, request_options: typing.Optional[RequestOptions] = None
+    ) -> typing.List[McpTool]:
+        """
+        Test connection to an MCP server without adding it.
+        Returns the list of available tools if successful.
+
+        Parameters
+        ----------
+        request : TestMcpServerRequest
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        typing.List[McpTool]
+            Successful Response
+
+        Examples
+        --------
+        from letta_client import Letta, StdioServerConfig
+
+        client = Letta(
+            token="YOUR_TOKEN",
+        )
+        client.tools.test_mcp_server(
+            request=StdioServerConfig(
+                server_name="server_name",
+                command="command",
+                args=["args"],
+            ),
+        )
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            "v1/tools/mcp/servers/test",
+            method="POST",
+            json=convert_and_respect_annotation_metadata(
+                object_=request, annotation=TestMcpServerRequest, direction="write"
+            ),
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    typing.List[McpTool],
+                    construct_type(
+                        type_=typing.List[McpTool],  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            if _response.status_code == 422:
+                raise UnprocessableEntityError(
+                    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, body=_response.text)
+        raise ApiError(status_code=_response.status_code, body=_response_json)
+
 
 class AsyncToolsClient:
     def __init__(self, *, client_wrapper: AsyncClientWrapper):
@@ -2714,3 +2782,78 @@ class AsyncToolsClient:
         except JSONDecodeError:
             raise ApiError(status_code=_response.status_code, body=_response.text)
         raise ApiError(status_code=_response.status_code, body=_response_json)
+
+    async def test_mcp_server(
+        self, *, request: TestMcpServerRequest, request_options: typing.Optional[RequestOptions] = None
+    ) -> typing.List[McpTool]:
+        """
+        Test connection to an MCP server without adding it.
+        Returns the list of available tools if successful.
+
+        Parameters
+        ----------
+        request : TestMcpServerRequest
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        typing.List[McpTool]
+            Successful Response
+
+        Examples
+        --------
+        import asyncio
+
+        from letta_client import AsyncLetta, StdioServerConfig
+
+        client = AsyncLetta(
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.tools.test_mcp_server(
+                request=StdioServerConfig(
+                    server_name="server_name",
+                    command="command",
+                    args=["args"],
+                ),
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            "v1/tools/mcp/servers/test",
+            method="POST",
+            json=convert_and_respect_annotation_metadata(
+                object_=request, annotation=TestMcpServerRequest, direction="write"
+            ),
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    typing.List[McpTool],
+                    construct_type(
+                        type_=typing.List[McpTool],  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            if _response.status_code == 422:
+                raise UnprocessableEntityError(
+                    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, body=_response.text)
+        raise ApiError(status_code=_response.status_code, body=_response_json)