letta-client 0.1.158__py3-none-any.whl → 0.1.160__py3-none-any.whl

letta_client/__init__.py

@@ -205,6 +205,7 @@ from .types import (
     TextContent,
     TextResponseFormat,
     Tool,
+    ToolAnnotations,
     ToolCall,
     ToolCallContent,
     ToolCallDelta,
@@ -547,6 +548,7 @@ __all__ = [
     "TextContent",
     "TextResponseFormat",
     "Tool",
+    "ToolAnnotations",
     "ToolCall",
     "ToolCallContent",
     "ToolCallDelta",

letta_client/agents/messages/client.py

@@ -438,6 +438,7 @@ class MessagesClient:
         agent_id: str,
         *,
         messages: typing.Sequence[MessageCreate],
+        callback_url: typing.Optional[str] = None,
         max_steps: typing.Optional[int] = OMIT,
         use_assistant_message: typing.Optional[bool] = OMIT,
         assistant_message_tool_name: typing.Optional[str] = OMIT,
@@ -456,6 +457,9 @@ class MessagesClient:
         messages : typing.Sequence[MessageCreate]
             The messages to be sent to the agent.
 
+        callback_url : typing.Optional[str]
+            Optional callback URL to POST to when the job completes
+
         max_steps : typing.Optional[int]
             Maximum number of steps the agent should take to process the request.
 
@@ -503,6 +507,9 @@ class MessagesClient:
         _response = self._client_wrapper.httpx_client.request(
             f"v1/agents/{jsonable_encoder(agent_id)}/messages/async",
             method="POST",
+            params={
+                "callback_url": callback_url,
+            },
             json={
                 "messages": convert_and_respect_annotation_metadata(
                     object_=messages, annotation=typing.Sequence[MessageCreate], direction="write"
@@ -1052,6 +1059,7 @@ class AsyncMessagesClient:
         agent_id: str,
         *,
         messages: typing.Sequence[MessageCreate],
+        callback_url: typing.Optional[str] = None,
         max_steps: typing.Optional[int] = OMIT,
         use_assistant_message: typing.Optional[bool] = OMIT,
         assistant_message_tool_name: typing.Optional[str] = OMIT,
@@ -1070,6 +1078,9 @@ class AsyncMessagesClient:
         messages : typing.Sequence[MessageCreate]
             The messages to be sent to the agent.
 
+        callback_url : typing.Optional[str]
+            Optional callback URL to POST to when the job completes
+
         max_steps : typing.Optional[int]
             Maximum number of steps the agent should take to process the request.
 
@@ -1125,6 +1136,9 @@ class AsyncMessagesClient:
         _response = await self._client_wrapper.httpx_client.request(
             f"v1/agents/{jsonable_encoder(agent_id)}/messages/async",
             method="POST",
+            params={
+                "callback_url": callback_url,
+            },
             json={
                 "messages": convert_and_respect_annotation_metadata(
                     object_=messages, annotation=typing.Sequence[MessageCreate], direction="write"

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

letta_client/types/__init__.py

@@ -208,6 +208,7 @@ from .terminal_tool_rule import TerminalToolRule
 from .text_content import TextContent
 from .text_response_format import TextResponseFormat
 from .tool import Tool
+from .tool_annotations import ToolAnnotations
 from .tool_call import ToolCall
 from .tool_call_content import ToolCallContent
 from .tool_call_delta import ToolCallDelta
@@ -452,6 +453,7 @@ __all__ = [
     "TextContent",
     "TextResponseFormat",
     "Tool",
+    "ToolAnnotations",
     "ToolCall",
     "ToolCallContent",
     "ToolCallDelta",

letta_client/types/mcp_server_type.py

@@ -2,4 +2,4 @@
 
 import typing
 
-McpServerType = typing.Union[typing.Literal["sse", "stdio"], typing.Any]
+McpServerType = typing.Union[typing.Literal["sse", "stdio", "streamable_http"], typing.Any]

letta_client/types/mcp_tool.py

@@ -4,6 +4,7 @@ from ..core.unchecked_base_model import UncheckedBaseModel
 import typing
 import typing_extensions
 from ..core.serialization import FieldMetadata
+from .tool_annotations import ToolAnnotations
 from ..core.pydantic_utilities import IS_PYDANTIC_V2
 import pydantic
 
@@ -18,6 +19,7 @@ class McpTool(UncheckedBaseModel):
     input_schema: typing_extensions.Annotated[
         typing.Dict[str, typing.Optional[typing.Any]], FieldMetadata(alias="inputSchema")
     ]
+    annotations: typing.Optional[ToolAnnotations] = None
 
     if IS_PYDANTIC_V2:
         model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2

letta_client/types/sse_server_config.py

@@ -8,6 +8,17 @@ from ..core.pydantic_utilities import IS_PYDANTIC_V2
 
 
 class SseServerConfig(UncheckedBaseModel):
+    """
+    Configuration for an MCP server using SSE
+
+    Authentication can be provided in multiple ways:
+    1. Using auth_header + auth_token: Will add a specific header with the token
+       Example: auth_header="Authorization", auth_token="Bearer abc123"
+
+    2. Using the custom_headers dict: For more complex authentication scenarios
+       Example: custom_headers={"X-API-Key": "abc123", "X-Custom-Header": "value"}
+    """
+
     server_name: str = pydantic.Field()
     """
     The name of the server
@@ -19,6 +30,21 @@ class SseServerConfig(UncheckedBaseModel):
     The URL of the server (MCP SSE client will connect to this URL)
     """
 
+    auth_header: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The name of the authentication header (e.g., 'Authorization')
+    """
+
+    auth_token: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The authentication token or API key value
+    """
+
+    custom_headers: typing.Optional[typing.Dict[str, typing.Optional[str]]] = pydantic.Field(default=None)
+    """
+    Custom HTTP headers to include with SSE requests
+    """
+
     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_annotations.py

@@ -0,0 +1,36 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.unchecked_base_model import UncheckedBaseModel
+import typing
+import typing_extensions
+from ..core.serialization import FieldMetadata
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+import pydantic
+
+
+class ToolAnnotations(UncheckedBaseModel):
+    """
+    Additional properties describing a Tool to clients.
+
+    NOTE: all properties in ToolAnnotations are **hints**.
+    They are not guaranteed to provide a faithful description of
+    tool behavior (including descriptive properties like `title`).
+
+    Clients should never make tool use decisions based on ToolAnnotations
+    received from untrusted servers.
+    """
+
+    title: typing.Optional[str] = None
+    read_only_hint: typing_extensions.Annotated[typing.Optional[bool], FieldMetadata(alias="readOnlyHint")] = None
+    destructive_hint: typing_extensions.Annotated[typing.Optional[bool], FieldMetadata(alias="destructiveHint")] = None
+    idempotent_hint: typing_extensions.Annotated[typing.Optional[bool], FieldMetadata(alias="idempotentHint")] = None
+    open_world_hint: typing_extensions.Annotated[typing.Optional[bool], FieldMetadata(alias="openWorldHint")] = None
+
+    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.158.dist-info → letta_client-0.1.160.dist-info}/METADATA

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

{letta_client-0.1.158.dist-info → letta_client-0.1.160.dist-info}/RECORD

@@ -1,4 +1,4 @@
-letta_client/__init__.py,sha256=2X95vFIKPYYoAtp_d437qy_T9kGhn3tSjgvglH3upKE,17194
+letta_client/__init__.py,sha256=glnhnX4D68CyvKpQaE5MZg0hobKzThfIUMTzxN537t8,17238
 letta_client/agents/__init__.py,sha256=3oFWVxaaxkphkjGJVk31Llb9ll9dKoCGx3B_r3qqtes,1716
 letta_client/agents/blocks/__init__.py,sha256=FTtvy8EDg9nNNg9WCatVgKTRYV8-_v1roeGPAKoa_pw,65
 letta_client/agents/blocks/client.py,sha256=ecE03lE5tP1AtCMFLT9FzdYyQMx_D7NI5m42b41pV40,24684
@@ -14,7 +14,7 @@ letta_client/agents/memory_variables/client.py,sha256=6qFVbR_tdfqj4HQ1h1HXR8DZCV
 letta_client/agents/memory_variables/types/__init__.py,sha256=EoznK0WvhCyFYd4KDdU-cGDQWpSXmq79BSkqVHN-j7A,180
 letta_client/agents/memory_variables/types/memory_variables_list_response.py,sha256=bsF__n_B4ZXEHzg--OVD6tHHXt_aM-FjHm2x1ZXPnL0,599
 letta_client/agents/messages/__init__.py,sha256=M7Ar6Rmb8we4dfYE6jj3FCL9UvVFy1bNQIPflUXMWHA,243
-letta_client/agents/messages/client.py,sha256=g_tE8kPO16g9aDrPPiMV_62R1yRxYDs-aU7iVEUMn6A,45087
+letta_client/agents/messages/client.py,sha256=4aSoniRmqmAOpi1bvGPm6Uj5QNuUqDIeIJe4LGDoELk,45579
 letta_client/agents/messages/types/__init__.py,sha256=Oc2j0oGOs96IEFf9xsJIkjBjoq3OMtse64YwWv3F9Io,335
 letta_client/agents/messages/types/letta_streaming_response.py,sha256=8VR2F32xjoPFXL4YBvBbAZclaJG4ENPTjk7BrlZkmtw,742
 letta_client/agents/messages/types/messages_modify_request.py,sha256=7C2X3BKye-YDSXOkdEmxxt34seI4jkLK0-govtc4nhg,475
@@ -62,7 +62,7 @@ letta_client/client_side_access_tokens/types/client_side_access_tokens_create_re
 letta_client/client_side_access_tokens/types/client_side_access_tokens_create_response_policy_data_item_access_item.py,sha256=R-H25IpNp9feSrW8Yj3h9O3UTMVvFniQJElogKxLuoE,254
 letta_client/core/__init__.py,sha256=OKbX2aCZXgHCDUsCouqv-OiX32xA6eFFCKIUH9M5Vzk,1591
 letta_client/core/api_error.py,sha256=RE8LELok2QCjABadECTvtDp7qejA1VmINCh6TbqPwSE,426
-letta_client/core/client_wrapper.py,sha256=nKg5nPtYoLHksAm6lUSNv3-Pw5OsuE2E5Gbkr-eEoBo,1998
+letta_client/core/client_wrapper.py,sha256=OR7PC0iFjMX-HCpZ4mNlEtGxyLpJH8MQuu_BOLQSH_o,1998
 letta_client/core/datetime_utils.py,sha256=nBys2IsYrhPdszxGKCNRPSOCwa-5DWOHG95FB8G9PKo,1047
 letta_client/core/file.py,sha256=d4NNbX8XvXP32z8KpK2Xovv33nFfruIrpz0QWxlgpZk,2663
 letta_client/core/http_client.py,sha256=Z77OIxIbL4OAB2IDqjRq_sYa5yNYAWfmdhdCSSvh6Y4,19552
@@ -150,7 +150,7 @@ letta_client/tools/types/add_mcp_server_request.py,sha256=EieZjfOT95sjkpxXdqy7gl
 letta_client/tools/types/add_mcp_server_response_item.py,sha256=pb3A4IoP7Qpen0UDDniXrASYEJZWnYnnrZThtPkvZt4,270
 letta_client/tools/types/delete_mcp_server_response_item.py,sha256=hKc4uehqcubO8BzpgMlvk2jJAjHXOWRM_zmWsCz_vZE,273
 letta_client/tools/types/list_mcp_servers_response_value.py,sha256=AIoXu4bO8QNSU7zjL1jj0Rg4313wVtPaTt13W0aevLQ,273
-letta_client/types/__init__.py,sha256=4sJJKkC2a_9Tt-jwNSuO_he06cojsUlkYpk45V3cL3Q,21720
+letta_client/types/__init__.py,sha256=QQWOfs0PC9QLo9L7vXvkcNVdGqaZFV2j1mmeNj8o1fI,21789
 letta_client/types/action_model.py,sha256=y1e2XMv3skFaNJIBdYoBKgiORzGh05aOVvu-qVR9uHg,1240
 letta_client/types/action_parameters_model.py,sha256=LgKf5aPZG3-OHGxFdXiSokIDgce8c02xPYIAY05VgW8,828
 letta_client/types/action_response_model.py,sha256=yq2Fd9UU8j7vvtE3VqXUoRRvDzWcfJPj_95ynGdeHCs,824
@@ -291,8 +291,8 @@ letta_client/types/local_sandbox_config.py,sha256=jfe7akG_YrJJ8csLaLdev04Zg1x-PT
 letta_client/types/manager_type.py,sha256=3ztXv2xWw6PIgDoqqxaHwdIcssDYqdqB0KqUDSW3Bc0,222
 letta_client/types/max_count_per_step_tool_rule.py,sha256=6vBWeGH2FW3ze--lr4DVuqG5aikPjKAAwHd4bfv4YcM,1225
 letta_client/types/max_count_per_step_tool_rule_schema.py,sha256=1Zq4vblRTqFycqk7cBQ3gVCUy-MPWvE_tNXV5Fz0VTs,618
-letta_client/types/mcp_server_type.py,sha256=Hv45mKMPzmey2UVjwrTAvWXP1sDd13UwAtvtogBloLo,153
-letta_client/types/mcp_tool.py,sha256=_GSTb0k8l-IUEflRkQ6-v45UnbTcA4Nv1N8sgmExJQ0,912
+letta_client/types/mcp_server_type.py,sha256=cEiRY8zJw3YdV0RV6tt4JUYd0AHT_UNeLgxaouU-_4A,172
+letta_client/types/mcp_tool.py,sha256=1Bdh9eDfLWxEB_5spzGXImmcoEQ2XRo8BTaeolaMA1M,1015
 letta_client/types/memory.py,sha256=Fa07vLHBsc4eNK65Yla2zOuzYhtgFGlnPzAGo9GvJ-c,1210
 letta_client/types/message.py,sha256=xLOrSRBL3GHlEN_aZAVR_ruftSqqDMu3CVnRnB01ZD0,4493
 letta_client/types/message_content_item.py,sha256=FrwERKfU5MpV4Y8LC5ejKFkoqqSV_Ooww-r32VGBbME,629
@@ -343,7 +343,7 @@ letta_client/types/sandbox_type.py,sha256=XSWmX3JIFFrDPQ4i89E8LauXY8kjmJEtaz6e_J
 letta_client/types/sleeptime_manager.py,sha256=oKI3CCoA4guwktWs1bbPdCmv9jg94EeMvbXQWvzbt6M,778
 letta_client/types/sleeptime_manager_update.py,sha256=JMzgtvGMDI5VBzlTuzm4FpuFAL7uwPbQgN9TYxip93s,813
 letta_client/types/source.py,sha256=BsfE9yrefXREQtskGZnR-TFGqmHkFKIGHC5udtHUi14,2370
-letta_client/types/sse_server_config.py,sha256=b-h5FLm5MELZ5A9bwZt-02Zx_f3UbfKAQS--yHQVOQU,844
+letta_client/types/sse_server_config.py,sha256=IN-FdECflYF-XiIM_fvVOwyDu215Csoixepv44PAVvQ,1738
 letta_client/types/stdio_server_config.py,sha256=dEQ7bguiLikGemLxYZJ3JCmmEQgAMsSPO_P52oHZSl0,1091
 letta_client/types/step.py,sha256=-5KHfBc6NZnYGLXHJMK6Bdyw2ae0G1zPFzsURjPiN3c,3133
 letta_client/types/stop_reason_type.py,sha256=PyYTS9bIvCSDfzyG4wJyk6bi9fCdDBNsoleLd7nMJYI,228
@@ -355,6 +355,7 @@ letta_client/types/terminal_tool_rule.py,sha256=E9XJMsIOAAERnTztXhbB0z4P-oBH0Bxn
 letta_client/types/text_content.py,sha256=Z8UL4Sqqq2qClKU_nCgR9XFCj3dwYyhZMmvnnz1F0AE,670
 letta_client/types/text_response_format.py,sha256=daIziOp-O4cEDqFH1CSIqb0p5BL721_kA0JSOtWlt0k,654
 letta_client/types/tool.py,sha256=5BtitT8tljb53PAVCZWeeKX6sLDUajgGAAJ2mJhiBp0,3054
+letta_client/types/tool_annotations.py,sha256=Is8FsHSHmA1NsH9_gx9f99I7Er4Xix2GV0khCjw7mGE,1504
 letta_client/types/tool_call.py,sha256=EKGAFwzoa6zMTpOkG55hWzFn_AgPrbLXSOu5M84x8WU,594
 letta_client/types/tool_call_content.py,sha256=5aceJgOQSkL05Hw5LXG49yxN8CmTcp6jj9aeQp-Wtks,995
 letta_client/types/tool_call_delta.py,sha256=wGeZwJ9pwYHD5-f4Unf5-vJqefK40eHw9i0w3bCjRoE,671
@@ -396,6 +397,6 @@ letta_client/types/web_search_options_user_location_approximate.py,sha256=Ywk01J
 letta_client/version.py,sha256=bttKLbIhO3UonCYQlqs600zzbQgfhCCMjeXR9WRzid4,79
 letta_client/voice/__init__.py,sha256=FTtvy8EDg9nNNg9WCatVgKTRYV8-_v1roeGPAKoa_pw,65
 letta_client/voice/client.py,sha256=EX79F2D5bieXNP8g1ZPw8xwAzqE1A3hshCHUSlTV1kw,5739
-letta_client-0.1.158.dist-info/METADATA,sha256=TADPzFpKPXVxzN0-didPXQNa94hW9b36Tzq96tj5y2Y,5093
-letta_client-0.1.158.dist-info/WHEEL,sha256=Zb28QaM1gQi8f4VCBhsUklF61CTlNYfs9YAZn-TOGFk,88
-letta_client-0.1.158.dist-info/RECORD,,
+letta_client-0.1.160.dist-info/METADATA,sha256=E1btYPdmlSnSdNg8p1mwJR9FgPX-xcwcmRKVtxQvDeY,5093
+letta_client-0.1.160.dist-info/WHEEL,sha256=Zb28QaM1gQi8f4VCBhsUklF61CTlNYfs9YAZn-TOGFk,88
+letta_client-0.1.160.dist-info/RECORD,,