telnyx 3.5.0a0__py3-none-any.whl → 3.6.0__py3-none-any.whl

telnyx/resources/ai/conversations/conversations.py

@@ -2,7 +2,8 @@
 
 from __future__ import annotations
 
-from typing import Dict
+from typing import Dict, Union, Iterable
+from datetime import datetime
 
 import httpx
 
@@ -22,10 +23,15 @@ from .messages import (
     MessagesResourceWithStreamingResponse,
     AsyncMessagesResourceWithStreamingResponse,
 )
-from ...._types import Body, Omit, Query, Headers, NoneType, NotGiven, omit, not_given
+from ...._types import Body, Omit, Query, Headers, NoneType, NotGiven, SequenceNotStr, omit, not_given
 from ...._utils import maybe_transform, async_maybe_transform
 from ...._compat import cached_property
-from ....types.ai import conversation_list_params, conversation_create_params, conversation_update_params
+from ....types.ai import (
+    conversation_list_params,
+    conversation_create_params,
+    conversation_update_params,
+    conversation_add_message_params,
+)
 from ...._resource import SyncAPIResource, AsyncAPIResource
 from ...._response import (
     to_raw_response_wrapper,
@@ -326,6 +332,64 @@ class ConversationsResource(SyncAPIResource):
             cast_to=NoneType,
         )
 
+    def add_message(
+        self,
+        conversation_id: str,
+        *,
+        role: str,
+        content: str | Omit = omit,
+        metadata: Dict[str, Union[str, int, bool, SequenceNotStr[Union[str, int, bool]]]] | Omit = omit,
+        name: str | Omit = omit,
+        sent_at: Union[str, datetime] | Omit = omit,
+        tool_call_id: str | Omit = omit,
+        tool_calls: Iterable[Dict[str, object]] | Omit = omit,
+        tool_choice: Union[str, object] | Omit = omit,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> object:
+        """Add a new message to the conversation.
+
+        Used to insert a new messages to a
+        conversation manually ( without using chat endpoint )
+
+        Args:
+          conversation_id: The ID of the conversation
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not conversation_id:
+            raise ValueError(f"Expected a non-empty value for `conversation_id` but received {conversation_id!r}")
+        return self._post(
+            f"/ai/conversations/{conversation_id}/message",
+            body=maybe_transform(
+                {
+                    "role": role,
+                    "content": content,
+                    "metadata": metadata,
+                    "name": name,
+                    "sent_at": sent_at,
+                    "tool_call_id": tool_call_id,
+                    "tool_calls": tool_calls,
+                    "tool_choice": tool_choice,
+                },
+                conversation_add_message_params.ConversationAddMessageParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=object,
+        )
+
     def retrieve_conversations_insights(
         self,
         conversation_id: str,
@@ -635,6 +699,64 @@ class AsyncConversationsResource(AsyncAPIResource):
             cast_to=NoneType,
         )
 
+    async def add_message(
+        self,
+        conversation_id: str,
+        *,
+        role: str,
+        content: str | Omit = omit,
+        metadata: Dict[str, Union[str, int, bool, SequenceNotStr[Union[str, int, bool]]]] | Omit = omit,
+        name: str | Omit = omit,
+        sent_at: Union[str, datetime] | Omit = omit,
+        tool_call_id: str | Omit = omit,
+        tool_calls: Iterable[Dict[str, object]] | Omit = omit,
+        tool_choice: Union[str, object] | Omit = omit,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> object:
+        """Add a new message to the conversation.
+
+        Used to insert a new messages to a
+        conversation manually ( without using chat endpoint )
+
+        Args:
+          conversation_id: The ID of the conversation
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not conversation_id:
+            raise ValueError(f"Expected a non-empty value for `conversation_id` but received {conversation_id!r}")
+        return await self._post(
+            f"/ai/conversations/{conversation_id}/message",
+            body=await async_maybe_transform(
+                {
+                    "role": role,
+                    "content": content,
+                    "metadata": metadata,
+                    "name": name,
+                    "sent_at": sent_at,
+                    "tool_call_id": tool_call_id,
+                    "tool_calls": tool_calls,
+                    "tool_choice": tool_choice,
+                },
+                conversation_add_message_params.ConversationAddMessageParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=object,
+        )
+
     async def retrieve_conversations_insights(
         self,
         conversation_id: str,
@@ -688,6 +810,9 @@ class ConversationsResourceWithRawResponse:
         self.delete = to_raw_response_wrapper(
             conversations.delete,
         )
+        self.add_message = to_raw_response_wrapper(
+            conversations.add_message,
+        )
         self.retrieve_conversations_insights = to_raw_response_wrapper(
             conversations.retrieve_conversations_insights,
         )
@@ -724,6 +849,9 @@ class AsyncConversationsResourceWithRawResponse:
         self.delete = async_to_raw_response_wrapper(
             conversations.delete,
         )
+        self.add_message = async_to_raw_response_wrapper(
+            conversations.add_message,
+        )
         self.retrieve_conversations_insights = async_to_raw_response_wrapper(
             conversations.retrieve_conversations_insights,
         )
@@ -760,6 +888,9 @@ class ConversationsResourceWithStreamingResponse:
         self.delete = to_streamed_response_wrapper(
             conversations.delete,
         )
+        self.add_message = to_streamed_response_wrapper(
+            conversations.add_message,
+        )
         self.retrieve_conversations_insights = to_streamed_response_wrapper(
             conversations.retrieve_conversations_insights,
         )
@@ -796,6 +927,9 @@ class AsyncConversationsResourceWithStreamingResponse:
         self.delete = async_to_streamed_response_wrapper(
             conversations.delete,
         )
+        self.add_message = async_to_streamed_response_wrapper(
+            conversations.add_message,
+        )
         self.retrieve_conversations_insights = async_to_streamed_response_wrapper(
             conversations.retrieve_conversations_insights,
         )

telnyx/resources/ai/conversations/messages.py

@@ -2,13 +2,9 @@
 
 from __future__ import annotations
 
-from typing import Dict, Union, Iterable
-from datetime import datetime
-
 import httpx
 
-from ...._types import Body, Omit, Query, Headers, NotGiven, SequenceNotStr, omit, not_given
-from ...._utils import maybe_transform, async_maybe_transform
+from ...._types import Body, Query, Headers, NotGiven, not_given
 from ...._compat import cached_property
 from ...._resource import SyncAPIResource, AsyncAPIResource
 from ...._response import (
@@ -18,7 +14,6 @@ from ...._response import (
     async_to_streamed_response_wrapper,
 )
 from ...._base_client import make_request_options
-from ....types.ai.conversations import message_create_params
 from ....types.ai.conversations.message_list_response import MessageListResponse
 
 __all__ = ["MessagesResource", "AsyncMessagesResource"]
@@ -44,64 +39,6 @@ class MessagesResource(SyncAPIResource):
         """
         return MessagesResourceWithStreamingResponse(self)
 
-    def create(
-        self,
-        conversation_id: str,
-        *,
-        role: str,
-        content: str | Omit = omit,
-        metadata: Dict[str, Union[str, int, bool, SequenceNotStr[Union[str, int, bool]]]] | Omit = omit,
-        name: str | Omit = omit,
-        sent_at: Union[str, datetime] | Omit = omit,
-        tool_call_id: str | Omit = omit,
-        tool_calls: Iterable[Dict[str, object]] | Omit = omit,
-        tool_choice: Union[str, object] | Omit = omit,
-        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
-        # The extra values given here take precedence over values defined on the client or passed to this method.
-        extra_headers: Headers | None = None,
-        extra_query: Query | None = None,
-        extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> object:
-        """Add a new message to the conversation.
-
-        Used to insert a new messages to a
-        conversation manually ( without using chat endpoint )
-
-        Args:
-          conversation_id: The ID of the conversation
-
-          extra_headers: Send extra headers
-
-          extra_query: Add additional query parameters to the request
-
-          extra_body: Add additional JSON properties to the request
-
-          timeout: Override the client-level default timeout for this request, in seconds
-        """
-        if not conversation_id:
-            raise ValueError(f"Expected a non-empty value for `conversation_id` but received {conversation_id!r}")
-        return self._post(
-            f"/ai/conversations/{conversation_id}/messages",
-            body=maybe_transform(
-                {
-                    "role": role,
-                    "content": content,
-                    "metadata": metadata,
-                    "name": name,
-                    "sent_at": sent_at,
-                    "tool_call_id": tool_call_id,
-                    "tool_calls": tool_calls,
-                    "tool_choice": tool_choice,
-                },
-                message_create_params.MessageCreateParams,
-            ),
-            options=make_request_options(
-                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
-            ),
-            cast_to=object,
-        )
-
     def list(
         self,
         conversation_id: str,
@@ -157,64 +94,6 @@ class AsyncMessagesResource(AsyncAPIResource):
         """
         return AsyncMessagesResourceWithStreamingResponse(self)
 
-    async def create(
-        self,
-        conversation_id: str,
-        *,
-        role: str,
-        content: str | Omit = omit,
-        metadata: Dict[str, Union[str, int, bool, SequenceNotStr[Union[str, int, bool]]]] | Omit = omit,
-        name: str | Omit = omit,
-        sent_at: Union[str, datetime] | Omit = omit,
-        tool_call_id: str | Omit = omit,
-        tool_calls: Iterable[Dict[str, object]] | Omit = omit,
-        tool_choice: Union[str, object] | Omit = omit,
-        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
-        # The extra values given here take precedence over values defined on the client or passed to this method.
-        extra_headers: Headers | None = None,
-        extra_query: Query | None = None,
-        extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> object:
-        """Add a new message to the conversation.
-
-        Used to insert a new messages to a
-        conversation manually ( without using chat endpoint )
-
-        Args:
-          conversation_id: The ID of the conversation
-
-          extra_headers: Send extra headers
-
-          extra_query: Add additional query parameters to the request
-
-          extra_body: Add additional JSON properties to the request
-
-          timeout: Override the client-level default timeout for this request, in seconds
-        """
-        if not conversation_id:
-            raise ValueError(f"Expected a non-empty value for `conversation_id` but received {conversation_id!r}")
-        return await self._post(
-            f"/ai/conversations/{conversation_id}/messages",
-            body=await async_maybe_transform(
-                {
-                    "role": role,
-                    "content": content,
-                    "metadata": metadata,
-                    "name": name,
-                    "sent_at": sent_at,
-                    "tool_call_id": tool_call_id,
-                    "tool_calls": tool_calls,
-                    "tool_choice": tool_choice,
-                },
-                message_create_params.MessageCreateParams,
-            ),
-            options=make_request_options(
-                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
-            ),
-            cast_to=object,
-        )
-
     async def list(
         self,
         conversation_id: str,
@@ -254,9 +133,6 @@ class MessagesResourceWithRawResponse:
     def __init__(self, messages: MessagesResource) -> None:
         self._messages = messages
 
-        self.create = to_raw_response_wrapper(
-            messages.create,
-        )
         self.list = to_raw_response_wrapper(
             messages.list,
         )
@@ -266,9 +142,6 @@ class AsyncMessagesResourceWithRawResponse:
     def __init__(self, messages: AsyncMessagesResource) -> None:
         self._messages = messages
 
-        self.create = async_to_raw_response_wrapper(
-            messages.create,
-        )
         self.list = async_to_raw_response_wrapper(
             messages.list,
         )
@@ -278,9 +151,6 @@ class MessagesResourceWithStreamingResponse:
     def __init__(self, messages: MessagesResource) -> None:
         self._messages = messages
 
-        self.create = to_streamed_response_wrapper(
-            messages.create,
-        )
         self.list = to_streamed_response_wrapper(
             messages.list,
         )
@@ -290,9 +160,6 @@ class AsyncMessagesResourceWithStreamingResponse:
     def __init__(self, messages: AsyncMessagesResource) -> None:
         self._messages = messages
 
-        self.create = async_to_streamed_response_wrapper(
-            messages.create,
-        )
         self.list = async_to_streamed_response_wrapper(
             messages.list,
         )

telnyx/resources/brand/brand.py

@@ -126,7 +126,8 @@ class BrandResource(SyncAPIResource):
 
           business_contact_email: Business contact email.
 
-              Required if `entityType` is `PUBLIC_PROFIT`.
+              Required if `entityType` is `PUBLIC_PROFIT`. Otherwise, it is recommended to
+              either omit this field or set it to `null`.
 
           city: City name
 
@@ -297,7 +298,8 @@ class BrandResource(SyncAPIResource):
 
           business_contact_email: Business contact email.
 
-              Required if `entityType` will be changed to `PUBLIC_PROFIT`.
+              Required if `entityType` will be changed to `PUBLIC_PROFIT`. Otherwise, it is
+              recommended to either omit this field or set it to `null`.
 
           city: City name
 
@@ -692,7 +694,8 @@ class AsyncBrandResource(AsyncAPIResource):
 
           business_contact_email: Business contact email.
 
-              Required if `entityType` is `PUBLIC_PROFIT`.
+              Required if `entityType` is `PUBLIC_PROFIT`. Otherwise, it is recommended to
+              either omit this field or set it to `null`.
 
           city: City name
 
@@ -863,7 +866,8 @@ class AsyncBrandResource(AsyncAPIResource):
 
           business_contact_email: Business contact email.
 
-              Required if `entityType` will be changed to `PUBLIC_PROFIT`.
+              Required if `entityType` will be changed to `PUBLIC_PROFIT`. Otherwise, it is
+              recommended to either omit this field or set it to `null`.
 
           city: City name