letta-client 0.1.112__py3-none-any.whl → 0.1.114__py3-none-any.whl

letta_client/__init__.py

@@ -113,6 +113,8 @@ from .types import (
     JobStatus,
     JobType,
     JsonSchema,
+    LettaBatchRequest,
+    LettaBatchResponse,
     LettaMessageContentUnion,
     LettaMessageUnion,
     LettaRequest,
@@ -391,6 +393,8 @@ __all__ = [
     "JobType",
     "JsonSchema",
     "Letta",
+    "LettaBatchRequest",
+    "LettaBatchResponse",
     "LettaEnvironment",
     "LettaMessageContentUnion",
     "LettaMessageUnion",

letta_client/agents/client.py

@@ -31,6 +31,8 @@ from .types.update_agent_tool_rules_item import UpdateAgentToolRulesItem
 import datetime as dt
 from ..types.passage import Passage
 from ..types.group import Group
+from ..types.letta_batch_request import LettaBatchRequest
+from ..types.letta_batch_response import LettaBatchResponse
 from .types.agents_search_request_search_item import AgentsSearchRequestSearchItem
 from .types.agents_search_response import AgentsSearchResponse
 from ..core.client_wrapper import AsyncClientWrapper
@@ -1158,6 +1160,141 @@ class AgentsClient:
             raise ApiError(status_code=_response.status_code, body=_response.text)
         raise ApiError(status_code=_response.status_code, body=_response_json)
 
+    def create_batch_message_request(
+        self, *, request: typing.Sequence[LettaBatchRequest], request_options: typing.Optional[RequestOptions] = None
+    ) -> LettaBatchResponse:
+        """
+        Submit a batch of agent messages for asynchronous processing.
+        Creates a job that will fan out messages to all listed agents and process them in parallel.
+
+        Parameters
+        ----------
+        request : typing.Sequence[LettaBatchRequest]
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        LettaBatchResponse
+            Successful Response
+
+        Examples
+        --------
+        from letta_client import Letta, LettaBatchRequest, MessageCreate, TextContent
+
+        client = Letta(
+            token="YOUR_TOKEN",
+        )
+        client.agents.create_batch_message_request(
+            request=[
+                LettaBatchRequest(
+                    messages=[
+                        MessageCreate(
+                            role="user",
+                            content=[
+                                TextContent(
+                                    text="text",
+                                )
+                            ],
+                        )
+                    ],
+                    agent_id="agent_id",
+                )
+            ],
+        )
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            "v1/agents/messages/batches",
+            method="POST",
+            json=convert_and_respect_annotation_metadata(
+                object_=request, annotation=typing.Sequence[LettaBatchRequest], direction="write"
+            ),
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    LettaBatchResponse,
+                    construct_type(
+                        type_=LettaBatchResponse,  # 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)
+
+    def retrieve_batch_message_request(
+        self, batch_id: str, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> LettaBatchResponse:
+        """
+        Retrieve the result or current status of a previously submitted batch message request.
+
+        Parameters
+        ----------
+        batch_id : str
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        LettaBatchResponse
+            Successful Response
+
+        Examples
+        --------
+        from letta_client import Letta
+
+        client = Letta(
+            token="YOUR_TOKEN",
+        )
+        client.agents.retrieve_batch_message_request(
+            batch_id="batch_id",
+        )
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            f"v1/agents/messages/batches/{jsonable_encoder(batch_id)}",
+            method="GET",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    LettaBatchResponse,
+                    construct_type(
+                        type_=LettaBatchResponse,  # 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)
+
     def search(
         self,
         *,
@@ -2427,6 +2564,162 @@ class AsyncAgentsClient:
             raise ApiError(status_code=_response.status_code, body=_response.text)
         raise ApiError(status_code=_response.status_code, body=_response_json)
 
+    async def create_batch_message_request(
+        self, *, request: typing.Sequence[LettaBatchRequest], request_options: typing.Optional[RequestOptions] = None
+    ) -> LettaBatchResponse:
+        """
+        Submit a batch of agent messages for asynchronous processing.
+        Creates a job that will fan out messages to all listed agents and process them in parallel.
+
+        Parameters
+        ----------
+        request : typing.Sequence[LettaBatchRequest]
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        LettaBatchResponse
+            Successful Response
+
+        Examples
+        --------
+        import asyncio
+
+        from letta_client import (
+            AsyncLetta,
+            LettaBatchRequest,
+            MessageCreate,
+            TextContent,
+        )
+
+        client = AsyncLetta(
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.agents.create_batch_message_request(
+                request=[
+                    LettaBatchRequest(
+                        messages=[
+                            MessageCreate(
+                                role="user",
+                                content=[
+                                    TextContent(
+                                        text="text",
+                                    )
+                                ],
+                            )
+                        ],
+                        agent_id="agent_id",
+                    )
+                ],
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            "v1/agents/messages/batches",
+            method="POST",
+            json=convert_and_respect_annotation_metadata(
+                object_=request, annotation=typing.Sequence[LettaBatchRequest], direction="write"
+            ),
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    LettaBatchResponse,
+                    construct_type(
+                        type_=LettaBatchResponse,  # 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)
+
+    async def retrieve_batch_message_request(
+        self, batch_id: str, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> LettaBatchResponse:
+        """
+        Retrieve the result or current status of a previously submitted batch message request.
+
+        Parameters
+        ----------
+        batch_id : str
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        LettaBatchResponse
+            Successful Response
+
+        Examples
+        --------
+        import asyncio
+
+        from letta_client import AsyncLetta
+
+        client = AsyncLetta(
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.agents.retrieve_batch_message_request(
+                batch_id="batch_id",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            f"v1/agents/messages/batches/{jsonable_encoder(batch_id)}",
+            method="GET",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    LettaBatchResponse,
+                    construct_type(
+                        type_=LettaBatchResponse,  # 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)
+
     async def search(
         self,
         *,

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

letta_client/types/__init__.py

@@ -112,6 +112,8 @@ from .job import Job
 from .job_status import JobStatus
 from .job_type import JobType
 from .json_schema import JsonSchema
+from .letta_batch_request import LettaBatchRequest
+from .letta_batch_response import LettaBatchResponse
 from .letta_message_content_union import LettaMessageContentUnion
 from .letta_message_union import LettaMessageUnion
 from .letta_request import LettaRequest
@@ -334,6 +336,8 @@ __all__ = [
     "JobStatus",
     "JobType",
     "JsonSchema",
+    "LettaBatchRequest",
+    "LettaBatchResponse",
     "LettaMessageContentUnion",
     "LettaMessageUnion",
     "LettaRequest",

letta_client/types/letta_batch_request.py

@@ -0,0 +1,43 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.unchecked_base_model import UncheckedBaseModel
+import typing
+from .message_create import MessageCreate
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+
+
+class LettaBatchRequest(UncheckedBaseModel):
+    messages: typing.List[MessageCreate] = pydantic.Field()
+    """
+    The messages to be sent to the agent.
+    """
+
+    use_assistant_message: typing.Optional[bool] = pydantic.Field(default=None)
+    """
+    Whether the server should parse specific tool call arguments (default `send_message`) as `AssistantMessage` objects.
+    """
+
+    assistant_message_tool_name: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The name of the designated message tool.
+    """
+
+    assistant_message_tool_kwarg: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The name of the message argument in the designated message tool.
+    """
+
+    agent_id: str = pydantic.Field()
+    """
+    The ID of the agent to send this batch request for
+    """
+
+    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/letta_batch_response.py

@@ -0,0 +1,44 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.unchecked_base_model import UncheckedBaseModel
+import pydantic
+from .job_status import JobStatus
+import datetime as dt
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+import typing
+
+
+class LettaBatchResponse(UncheckedBaseModel):
+    batch_id: str = pydantic.Field()
+    """
+    A unique identifier for this batch request.
+    """
+
+    status: JobStatus = pydantic.Field()
+    """
+    The current status of the batch request.
+    """
+
+    agent_count: int = pydantic.Field()
+    """
+    The number of agents in the batch request.
+    """
+
+    last_polled_at: dt.datetime = pydantic.Field()
+    """
+    The timestamp when the batch was last polled for updates.
+    """
+
+    created_at: dt.datetime = pydantic.Field()
+    """
+    The timestamp when the batch request was created.
+    """
+
+    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.112.dist-info → letta_client-0.1.114.dist-info}/METADATA

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

{letta_client-0.1.112.dist-info → letta_client-0.1.114.dist-info}/RECORD

@@ -1,8 +1,8 @@
-letta_client/__init__.py,sha256=pij5j_AglAp0VqY5FqJ23BIaYulP95I298DZz_8H7uk,14565
+letta_client/__init__.py,sha256=d1gnZZWntFsL6yIr_dKOqcnHqMkHuHvkiXC35I5vrUs,14663
 letta_client/agents/__init__.py,sha256=CveigJGrnkw3yZ8S9yZ2DpK1HV0v1fU-khsiLJJ0uaU,1452
 letta_client/agents/blocks/__init__.py,sha256=FTtvy8EDg9nNNg9WCatVgKTRYV8-_v1roeGPAKoa_pw,65
 letta_client/agents/blocks/client.py,sha256=u5zvutxoH_DqfSLWhRtNSRBC9_ezQDx682cxkxDz3JA,23822
-letta_client/agents/client.py,sha256=ku9SdcBr0WmR5pjwD1kfq4EMuH-BM3WROO-uda2pul4,93545
+letta_client/agents/client.py,sha256=VGKkSVTJ5j52fIh7PSNmMBD7gd0ZBu3dYcDPRoYU6as,103492
 letta_client/agents/context/__init__.py,sha256=FTtvy8EDg9nNNg9WCatVgKTRYV8-_v1roeGPAKoa_pw,65
 letta_client/agents/context/client.py,sha256=GKKvoG4N_K8Biz9yDjeIHpFG0C8Cwc7tHmEX3pTL_9U,4815
 letta_client/agents/core_memory/__init__.py,sha256=FTtvy8EDg9nNNg9WCatVgKTRYV8-_v1roeGPAKoa_pw,65
@@ -44,7 +44,7 @@ letta_client/blocks/client.py,sha256=LE9dsHaBxFLC3G035f0VpNDG7XKWRK8y9OXpeFCMvUw
 letta_client/client.py,sha256=k2mZqqEWciVmEQHgipjCK4kQILk74hpSqzcdNwdql9A,21212
 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=LYs3mur-os4giyagppiEczxlQACLHY_kE32cio3SpiM,1998
+letta_client/core/client_wrapper.py,sha256=J-2xR0tPxzouI60voBOA1Cj19O7nBlMt7WXGhSqr9Qs,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
@@ -106,7 +106,7 @@ letta_client/tools/types/add_mcp_server_request.py,sha256=EieZjfOT95sjkpxXdqy7gl
 letta_client/tools/types/add_mcp_server_response_item.py,sha256=TWdsKqGb1INhYtpGnAckz0Pw4nZShumSp4pfocRfxCA,270
 letta_client/tools/types/delete_mcp_server_response_item.py,sha256=MeZObU-7tMSCd-S5yuUjNDse6A1hUz1LLjbko0pXaro,273
 letta_client/tools/types/list_mcp_servers_response_value.py,sha256=AIoXu4bO8QNSU7zjL1jj0Rg4313wVtPaTt13W0aevLQ,273
-letta_client/types/__init__.py,sha256=Yf0Y1lIFZHtKw9Z1UnZXhORlFABZzabzpWHoZ589pMQ,19620
+letta_client/types/__init__.py,sha256=3g30SRiC6aVG5mzeT9BPulQNV0A6IdK8msZiMofiHSs,19775
 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
@@ -219,6 +219,8 @@ letta_client/types/job.py,sha256=VJBdFIY0rwqh4hObTchlU2jrloTjZwUEA44pNtY_JBg,232
 letta_client/types/job_status.py,sha256=lX5Q0QMQFnw-WiirqHD6kgBvGr6I7r8rKLnMJdqhlT8,239
 letta_client/types/job_type.py,sha256=Roa04Ry0I-8YMYcDHiHSQwqBavZyPonzkZtjf098e-Q,145
 letta_client/types/json_schema.py,sha256=EHcLKBSGRsSzCKTpujKFHylcLJG6ODQIBrjQkU4lWDQ,870
+letta_client/types/letta_batch_request.py,sha256=HdIuaaUaqINbau98jPqyIc7Ge84VlCf6VhAQpIhCFvQ,1354
+letta_client/types/letta_batch_response.py,sha256=i1KP1aZh710acu5bKNmcmdiheuPrKbkJr4_e2K2ki_k,1161
 letta_client/types/letta_message_content_union.py,sha256=YxzyXKxUMeqbqWOlDs9LC8HUiqEhgkNCV9a76GS3spg,486
 letta_client/types/letta_message_union.py,sha256=TTQwlur2CZNdZ466Nb_2TFcSFXrgoMliaNzD33t7Ktw,603
 letta_client/types/letta_request.py,sha256=bCPDRJhSJSo5eILJp0mTw_k26O3dZL1vChfAcaZ0rE8,1240
@@ -328,6 +330,6 @@ letta_client/voice/__init__.py,sha256=7hX85553PiRMtIMM12a0DSoFzsglNiUziYR2ekS84Q
 letta_client/voice/client.py,sha256=STjswa5oOLoP59QwTJvQwi73kgn0UzKOaXc2CsTRI4k,6912
 letta_client/voice/types/__init__.py,sha256=FRc3iKRTONE4N8Lf1IqvnqWZ2kXdrFFvkL7PxVcR8Ew,212
 letta_client/voice/types/create_voice_chat_completions_request_body.py,sha256=ZLfKgNK1T6IAwLEvaBVFfy7jEAoPUXP28n-nfmHkklc,391
-letta_client-0.1.112.dist-info/METADATA,sha256=NDcX0FrfdHY3zbDOcPZ7-X2rs3lpVVBcAjUrjG5eXLY,5042
-letta_client-0.1.112.dist-info/WHEEL,sha256=Zb28QaM1gQi8f4VCBhsUklF61CTlNYfs9YAZn-TOGFk,88
-letta_client-0.1.112.dist-info/RECORD,,
+letta_client-0.1.114.dist-info/METADATA,sha256=1wNYLSLYEtjzRn9GgYNSvEcrCbdtBISBKPaDjpuAw_0,5042
+letta_client-0.1.114.dist-info/WHEEL,sha256=Zb28QaM1gQi8f4VCBhsUklF61CTlNYfs9YAZn-TOGFk,88
+letta_client-0.1.114.dist-info/RECORD,,