telnyx 3.0.0a0__py3-none-any.whl → 3.1.0__py3-none-any.whl

telnyx/resources/ai/audio.py

@@ -7,7 +7,7 @@ from typing_extensions import Literal
 
 import httpx
 
-from ..._types import NOT_GIVEN, Body, Query, Headers, NotGiven, FileTypes
+from ..._types import Body, Omit, Query, Headers, NotGiven, FileTypes, omit, not_given
 from ..._utils import extract_files, maybe_transform, deepcopy_minimal, async_maybe_transform
 from ..._compat import cached_property
 from ...types.ai import audio_transcribe_params
@@ -48,16 +48,16 @@ class AudioResource(SyncAPIResource):
         self,
         *,
         model: Literal["distil-whisper/distil-large-v2", "openai/whisper-large-v3-turbo"],
-        file: FileTypes | NotGiven = NOT_GIVEN,
-        file_url: str | NotGiven = NOT_GIVEN,
-        response_format: Literal["json", "verbose_json"] | NotGiven = NOT_GIVEN,
-        timestamp_granularities: Literal["segment"] | NotGiven = NOT_GIVEN,
+        file: FileTypes | Omit = omit,
+        file_url: str | Omit = omit,
+        response_format: Literal["json", "verbose_json"] | Omit = omit,
+        timestamp_granularities: Literal["segment"] | 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,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> AudioTranscribeResponse:
         """Transcribe speech to text.
 
@@ -142,16 +142,16 @@ class AsyncAudioResource(AsyncAPIResource):
         self,
         *,
         model: Literal["distil-whisper/distil-large-v2", "openai/whisper-large-v3-turbo"],
-        file: FileTypes | NotGiven = NOT_GIVEN,
-        file_url: str | NotGiven = NOT_GIVEN,
-        response_format: Literal["json", "verbose_json"] | NotGiven = NOT_GIVEN,
-        timestamp_granularities: Literal["segment"] | NotGiven = NOT_GIVEN,
+        file: FileTypes | Omit = omit,
+        file_url: str | Omit = omit,
+        response_format: Literal["json", "verbose_json"] | Omit = omit,
+        timestamp_granularities: Literal["segment"] | 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,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> AudioTranscribeResponse:
         """Transcribe speech to text.
 

telnyx/resources/ai/chat.py

@@ -2,12 +2,12 @@
 
 from __future__ import annotations
 
-from typing import Dict, List, Iterable
+from typing import Dict, Iterable
 from typing_extensions import Literal
 
 import httpx
 
-from ..._types import NOT_GIVEN, Body, Query, Headers, NotGiven
+from ..._types import Body, Omit, Query, Headers, NotGiven, SequenceNotStr, omit, not_given
 from ..._utils import maybe_transform, async_maybe_transform
 from ..._compat import cached_property
 from ...types.ai import chat_create_completion_params
@@ -47,34 +47,34 @@ class ChatResource(SyncAPIResource):
         self,
         *,
         messages: Iterable[chat_create_completion_params.Message],
-        api_key_ref: str | NotGiven = NOT_GIVEN,
-        best_of: int | NotGiven = NOT_GIVEN,
-        early_stopping: bool | NotGiven = NOT_GIVEN,
-        frequency_penalty: float | NotGiven = NOT_GIVEN,
-        guided_choice: List[str] | NotGiven = NOT_GIVEN,
-        guided_json: Dict[str, object] | NotGiven = NOT_GIVEN,
-        guided_regex: str | NotGiven = NOT_GIVEN,
-        length_penalty: float | NotGiven = NOT_GIVEN,
-        logprobs: bool | NotGiven = NOT_GIVEN,
-        max_tokens: int | NotGiven = NOT_GIVEN,
-        min_p: float | NotGiven = NOT_GIVEN,
-        model: str | NotGiven = NOT_GIVEN,
-        n: float | NotGiven = NOT_GIVEN,
-        presence_penalty: float | NotGiven = NOT_GIVEN,
-        response_format: chat_create_completion_params.ResponseFormat | NotGiven = NOT_GIVEN,
-        stream: bool | NotGiven = NOT_GIVEN,
-        temperature: float | NotGiven = NOT_GIVEN,
-        tool_choice: Literal["none", "auto", "required"] | NotGiven = NOT_GIVEN,
-        tools: Iterable[chat_create_completion_params.Tool] | NotGiven = NOT_GIVEN,
-        top_logprobs: int | NotGiven = NOT_GIVEN,
-        top_p: float | NotGiven = NOT_GIVEN,
-        use_beam_search: bool | NotGiven = NOT_GIVEN,
+        api_key_ref: str | Omit = omit,
+        best_of: int | Omit = omit,
+        early_stopping: bool | Omit = omit,
+        frequency_penalty: float | Omit = omit,
+        guided_choice: SequenceNotStr[str] | Omit = omit,
+        guided_json: Dict[str, object] | Omit = omit,
+        guided_regex: str | Omit = omit,
+        length_penalty: float | Omit = omit,
+        logprobs: bool | Omit = omit,
+        max_tokens: int | Omit = omit,
+        min_p: float | Omit = omit,
+        model: str | Omit = omit,
+        n: float | Omit = omit,
+        presence_penalty: float | Omit = omit,
+        response_format: chat_create_completion_params.ResponseFormat | Omit = omit,
+        stream: bool | Omit = omit,
+        temperature: float | Omit = omit,
+        tool_choice: Literal["none", "auto", "required"] | Omit = omit,
+        tools: Iterable[chat_create_completion_params.Tool] | Omit = omit,
+        top_logprobs: int | Omit = omit,
+        top_p: float | Omit = omit,
+        use_beam_search: bool | 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,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> object:
         """Chat with a language model.
 
@@ -222,34 +222,34 @@ class AsyncChatResource(AsyncAPIResource):
         self,
         *,
         messages: Iterable[chat_create_completion_params.Message],
-        api_key_ref: str | NotGiven = NOT_GIVEN,
-        best_of: int | NotGiven = NOT_GIVEN,
-        early_stopping: bool | NotGiven = NOT_GIVEN,
-        frequency_penalty: float | NotGiven = NOT_GIVEN,
-        guided_choice: List[str] | NotGiven = NOT_GIVEN,
-        guided_json: Dict[str, object] | NotGiven = NOT_GIVEN,
-        guided_regex: str | NotGiven = NOT_GIVEN,
-        length_penalty: float | NotGiven = NOT_GIVEN,
-        logprobs: bool | NotGiven = NOT_GIVEN,
-        max_tokens: int | NotGiven = NOT_GIVEN,
-        min_p: float | NotGiven = NOT_GIVEN,
-        model: str | NotGiven = NOT_GIVEN,
-        n: float | NotGiven = NOT_GIVEN,
-        presence_penalty: float | NotGiven = NOT_GIVEN,
-        response_format: chat_create_completion_params.ResponseFormat | NotGiven = NOT_GIVEN,
-        stream: bool | NotGiven = NOT_GIVEN,
-        temperature: float | NotGiven = NOT_GIVEN,
-        tool_choice: Literal["none", "auto", "required"] | NotGiven = NOT_GIVEN,
-        tools: Iterable[chat_create_completion_params.Tool] | NotGiven = NOT_GIVEN,
-        top_logprobs: int | NotGiven = NOT_GIVEN,
-        top_p: float | NotGiven = NOT_GIVEN,
-        use_beam_search: bool | NotGiven = NOT_GIVEN,
+        api_key_ref: str | Omit = omit,
+        best_of: int | Omit = omit,
+        early_stopping: bool | Omit = omit,
+        frequency_penalty: float | Omit = omit,
+        guided_choice: SequenceNotStr[str] | Omit = omit,
+        guided_json: Dict[str, object] | Omit = omit,
+        guided_regex: str | Omit = omit,
+        length_penalty: float | Omit = omit,
+        logprobs: bool | Omit = omit,
+        max_tokens: int | Omit = omit,
+        min_p: float | Omit = omit,
+        model: str | Omit = omit,
+        n: float | Omit = omit,
+        presence_penalty: float | Omit = omit,
+        response_format: chat_create_completion_params.ResponseFormat | Omit = omit,
+        stream: bool | Omit = omit,
+        temperature: float | Omit = omit,
+        tool_choice: Literal["none", "auto", "required"] | Omit = omit,
+        tools: Iterable[chat_create_completion_params.Tool] | Omit = omit,
+        top_logprobs: int | Omit = omit,
+        top_p: float | Omit = omit,
+        use_beam_search: bool | 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,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> object:
         """Chat with a language model.
 

telnyx/resources/ai/clusters.py

@@ -2,11 +2,9 @@
 
 from __future__ import annotations
 
-from typing import List
-
 import httpx
 
-from ..._types import NOT_GIVEN, Body, Query, Headers, NoneType, NotGiven
+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 cluster_list_params, cluster_compute_params, cluster_retrieve_params, cluster_fetch_graph_params
@@ -49,14 +47,14 @@ class ClustersResource(SyncAPIResource):
         self,
         task_id: str,
         *,
-        show_subclusters: bool | NotGiven = NOT_GIVEN,
-        top_n_nodes: int | NotGiven = NOT_GIVEN,
+        show_subclusters: bool | Omit = omit,
+        top_n_nodes: int | 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,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> ClusterRetrieveResponse:
         """
         Fetch a cluster
@@ -98,13 +96,13 @@ class ClustersResource(SyncAPIResource):
     def list(
         self,
         *,
-        page: cluster_list_params.Page | NotGiven = NOT_GIVEN,
+        page: cluster_list_params.Page | 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,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> ClusterListResponse:
         """List all clusters
 
@@ -143,7 +141,7 @@ class ClustersResource(SyncAPIResource):
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> None:
         """
         Delete a cluster
@@ -172,16 +170,16 @@ class ClustersResource(SyncAPIResource):
         self,
         *,
         bucket: str,
-        files: List[str] | NotGiven = NOT_GIVEN,
-        min_cluster_size: int | NotGiven = NOT_GIVEN,
-        min_subcluster_size: int | NotGiven = NOT_GIVEN,
-        prefix: str | NotGiven = NOT_GIVEN,
+        files: SequenceNotStr[str] | Omit = omit,
+        min_cluster_size: int | Omit = omit,
+        min_subcluster_size: int | Omit = omit,
+        prefix: str | 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,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> ClusterComputeResponse:
         """
         Starts a background task to compute how the data in an
@@ -233,13 +231,13 @@ class ClustersResource(SyncAPIResource):
         self,
         task_id: str,
         *,
-        cluster_id: int | NotGiven = NOT_GIVEN,
+        cluster_id: int | 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,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> object:
         """
         Fetch a cluster visualization
@@ -292,14 +290,14 @@ class AsyncClustersResource(AsyncAPIResource):
         self,
         task_id: str,
         *,
-        show_subclusters: bool | NotGiven = NOT_GIVEN,
-        top_n_nodes: int | NotGiven = NOT_GIVEN,
+        show_subclusters: bool | Omit = omit,
+        top_n_nodes: int | 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,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> ClusterRetrieveResponse:
         """
         Fetch a cluster
@@ -341,13 +339,13 @@ class AsyncClustersResource(AsyncAPIResource):
     async def list(
         self,
         *,
-        page: cluster_list_params.Page | NotGiven = NOT_GIVEN,
+        page: cluster_list_params.Page | 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,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> ClusterListResponse:
         """List all clusters
 
@@ -386,7 +384,7 @@ class AsyncClustersResource(AsyncAPIResource):
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> None:
         """
         Delete a cluster
@@ -415,16 +413,16 @@ class AsyncClustersResource(AsyncAPIResource):
         self,
         *,
         bucket: str,
-        files: List[str] | NotGiven = NOT_GIVEN,
-        min_cluster_size: int | NotGiven = NOT_GIVEN,
-        min_subcluster_size: int | NotGiven = NOT_GIVEN,
-        prefix: str | NotGiven = NOT_GIVEN,
+        files: SequenceNotStr[str] | Omit = omit,
+        min_cluster_size: int | Omit = omit,
+        min_subcluster_size: int | Omit = omit,
+        prefix: str | 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,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> ClusterComputeResponse:
         """
         Starts a background task to compute how the data in an
@@ -476,13 +474,13 @@ class AsyncClustersResource(AsyncAPIResource):
         self,
         task_id: str,
         *,
-        cluster_id: int | NotGiven = NOT_GIVEN,
+        cluster_id: int | 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,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> object:
         """
         Fetch a cluster visualization