telnyx 3.3.0a0__py3-none-any.whl → 3.5.0a0__py3-none-any.whl

telnyx/resources/ai/conversations/insight_groups/insight_groups.py

@@ -12,7 +12,7 @@ from .insights import (
     InsightsResourceWithStreamingResponse,
     AsyncInsightsResourceWithStreamingResponse,
 )
-from ....._types import NOT_GIVEN, Body, Query, Headers, NotGiven
+from ....._types import Body, Omit, Query, Headers, NotGiven, omit, not_given
 from ....._utils import maybe_transform, async_maybe_transform
 from ....._compat import cached_property
 from ....._resource import SyncAPIResource, AsyncAPIResource
@@ -69,7 +69,7 @@ class InsightGroupsResource(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,
     ) -> InsightTemplateGroupDetail:
         """
         Get insight group by ID
@@ -99,15 +99,15 @@ class InsightGroupsResource(SyncAPIResource):
         self,
         group_id: str,
         *,
-        description: str | NotGiven = NOT_GIVEN,
-        name: str | NotGiven = NOT_GIVEN,
-        webhook: str | NotGiven = NOT_GIVEN,
+        description: str | Omit = omit,
+        name: str | Omit = omit,
+        webhook: 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,
     ) -> InsightTemplateGroupDetail:
         """
         Update an insight template group
@@ -150,7 +150,7 @@ class InsightGroupsResource(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,
     ) -> object:
         """
         Delete insight group by ID
@@ -180,14 +180,14 @@ class InsightGroupsResource(SyncAPIResource):
         self,
         *,
         name: str,
-        description: str | NotGiven = NOT_GIVEN,
-        webhook: str | NotGiven = NOT_GIVEN,
+        description: str | Omit = omit,
+        webhook: 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,
     ) -> InsightTemplateGroupDetail:
         """
         Create a new insight group
@@ -220,13 +220,13 @@ class InsightGroupsResource(SyncAPIResource):
     def retrieve_insight_groups(
         self,
         *,
-        page: insight_group_retrieve_insight_groups_params.Page | NotGiven = NOT_GIVEN,
+        page: insight_group_retrieve_insight_groups_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,
     ) -> InsightGroupRetrieveInsightGroupsResponse:
         """
         Get all insight groups
@@ -291,7 +291,7 @@ class AsyncInsightGroupsResource(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,
     ) -> InsightTemplateGroupDetail:
         """
         Get insight group by ID
@@ -321,15 +321,15 @@ class AsyncInsightGroupsResource(AsyncAPIResource):
         self,
         group_id: str,
         *,
-        description: str | NotGiven = NOT_GIVEN,
-        name: str | NotGiven = NOT_GIVEN,
-        webhook: str | NotGiven = NOT_GIVEN,
+        description: str | Omit = omit,
+        name: str | Omit = omit,
+        webhook: 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,
     ) -> InsightTemplateGroupDetail:
         """
         Update an insight template group
@@ -372,7 +372,7 @@ class AsyncInsightGroupsResource(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,
     ) -> object:
         """
         Delete insight group by ID
@@ -402,14 +402,14 @@ class AsyncInsightGroupsResource(AsyncAPIResource):
         self,
         *,
         name: str,
-        description: str | NotGiven = NOT_GIVEN,
-        webhook: str | NotGiven = NOT_GIVEN,
+        description: str | Omit = omit,
+        webhook: 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,
     ) -> InsightTemplateGroupDetail:
         """
         Create a new insight group
@@ -442,13 +442,13 @@ class AsyncInsightGroupsResource(AsyncAPIResource):
     async def retrieve_insight_groups(
         self,
         *,
-        page: insight_group_retrieve_insight_groups_params.Page | NotGiven = NOT_GIVEN,
+        page: insight_group_retrieve_insight_groups_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,
     ) -> InsightGroupRetrieveInsightGroupsResponse:
         """
         Get all insight groups

telnyx/resources/ai/conversations/insight_groups/insights.py

@@ -4,7 +4,7 @@ from __future__ import annotations
 
 import httpx
 
-from ....._types import NOT_GIVEN, Body, Query, Headers, NotGiven
+from ....._types import Body, Query, Headers, NotGiven, not_given
 from ....._compat import cached_property
 from ....._resource import SyncAPIResource, AsyncAPIResource
 from ....._response import (
@@ -48,7 +48,7 @@ class InsightsResource(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,
     ) -> object:
         """
         Assign an insight to a group
@@ -88,7 +88,7 @@ class InsightsResource(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,
     ) -> object:
         """
         Remove an insight from a group
@@ -149,7 +149,7 @@ class AsyncInsightsResource(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,
     ) -> object:
         """
         Assign an insight to a group
@@ -189,7 +189,7 @@ class AsyncInsightsResource(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,
     ) -> object:
         """
         Remove an insight from a group

telnyx/resources/ai/conversations/insights.py

@@ -6,7 +6,7 @@ from typing import Union
 
 import httpx
 
-from ...._types import NOT_GIVEN, Body, Query, Headers, NotGiven
+from ...._types import Body, Omit, Query, Headers, NotGiven, omit, not_given
 from ...._utils import maybe_transform, async_maybe_transform
 from ...._compat import cached_property
 from ...._resource import SyncAPIResource, AsyncAPIResource
@@ -49,14 +49,14 @@ class InsightsResource(SyncAPIResource):
         *,
         instructions: str,
         name: str,
-        json_schema: Union[str, object] | NotGiven = NOT_GIVEN,
-        webhook: str | NotGiven = NOT_GIVEN,
+        json_schema: Union[str, object] | Omit = omit,
+        webhook: 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,
     ) -> InsightTemplateDetail:
         """
         Create a new insight
@@ -98,7 +98,7 @@ class InsightsResource(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,
     ) -> InsightTemplateDetail:
         """
         Get insight by ID
@@ -128,16 +128,16 @@ class InsightsResource(SyncAPIResource):
         self,
         insight_id: str,
         *,
-        instructions: str | NotGiven = NOT_GIVEN,
-        json_schema: Union[str, object] | NotGiven = NOT_GIVEN,
-        name: str | NotGiven = NOT_GIVEN,
-        webhook: str | NotGiven = NOT_GIVEN,
+        instructions: str | Omit = omit,
+        json_schema: Union[str, object] | Omit = omit,
+        name: str | Omit = omit,
+        webhook: 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,
     ) -> InsightTemplateDetail:
         """
         Update an insight template
@@ -175,13 +175,13 @@ class InsightsResource(SyncAPIResource):
     def list(
         self,
         *,
-        page: insight_list_params.Page | NotGiven = NOT_GIVEN,
+        page: insight_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,
     ) -> InsightListResponse:
         """Get all insights
 
@@ -220,7 +220,7 @@ class InsightsResource(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,
     ) -> object:
         """
         Delete insight by ID
@@ -272,14 +272,14 @@ class AsyncInsightsResource(AsyncAPIResource):
         *,
         instructions: str,
         name: str,
-        json_schema: Union[str, object] | NotGiven = NOT_GIVEN,
-        webhook: str | NotGiven = NOT_GIVEN,
+        json_schema: Union[str, object] | Omit = omit,
+        webhook: 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,
     ) -> InsightTemplateDetail:
         """
         Create a new insight
@@ -321,7 +321,7 @@ class AsyncInsightsResource(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,
     ) -> InsightTemplateDetail:
         """
         Get insight by ID
@@ -351,16 +351,16 @@ class AsyncInsightsResource(AsyncAPIResource):
         self,
         insight_id: str,
         *,
-        instructions: str | NotGiven = NOT_GIVEN,
-        json_schema: Union[str, object] | NotGiven = NOT_GIVEN,
-        name: str | NotGiven = NOT_GIVEN,
-        webhook: str | NotGiven = NOT_GIVEN,
+        instructions: str | Omit = omit,
+        json_schema: Union[str, object] | Omit = omit,
+        name: str | Omit = omit,
+        webhook: 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,
     ) -> InsightTemplateDetail:
         """
         Update an insight template
@@ -398,13 +398,13 @@ class AsyncInsightsResource(AsyncAPIResource):
     async def list(
         self,
         *,
-        page: insight_list_params.Page | NotGiven = NOT_GIVEN,
+        page: insight_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,
     ) -> InsightListResponse:
         """Get all insights
 
@@ -443,7 +443,7 @@ class AsyncInsightsResource(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,
     ) -> object:
         """
         Delete insight by ID

telnyx/resources/ai/conversations/messages.py

@@ -2,12 +2,12 @@
 
 from __future__ import annotations
 
-from typing import Dict, List, Union, Iterable
+from typing import Dict, Union, Iterable
 from datetime import datetime
 
 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 ...._resource import SyncAPIResource, AsyncAPIResource
@@ -49,19 +49,19 @@ class MessagesResource(SyncAPIResource):
         conversation_id: str,
         *,
         role: str,
-        content: str | NotGiven = NOT_GIVEN,
-        metadata: Dict[str, Union[str, int, bool, List[Union[str, int, bool]]]] | NotGiven = NOT_GIVEN,
-        name: str | NotGiven = NOT_GIVEN,
-        sent_at: Union[str, datetime] | NotGiven = NOT_GIVEN,
-        tool_call_id: str | NotGiven = NOT_GIVEN,
-        tool_calls: Iterable[Dict[str, object]] | NotGiven = NOT_GIVEN,
-        tool_choice: Union[str, object] | NotGiven = NOT_GIVEN,
+        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,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> object:
         """Add a new message to the conversation.
 
@@ -111,7 +111,7 @@ class MessagesResource(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,
     ) -> MessageListResponse:
         """
         Retrieve messages for a specific conversation, including tool calls made by the
@@ -162,19 +162,19 @@ class AsyncMessagesResource(AsyncAPIResource):
         conversation_id: str,
         *,
         role: str,
-        content: str | NotGiven = NOT_GIVEN,
-        metadata: Dict[str, Union[str, int, bool, List[Union[str, int, bool]]]] | NotGiven = NOT_GIVEN,
-        name: str | NotGiven = NOT_GIVEN,
-        sent_at: Union[str, datetime] | NotGiven = NOT_GIVEN,
-        tool_call_id: str | NotGiven = NOT_GIVEN,
-        tool_calls: Iterable[Dict[str, object]] | NotGiven = NOT_GIVEN,
-        tool_choice: Union[str, object] | NotGiven = NOT_GIVEN,
+        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,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> object:
         """Add a new message to the conversation.
 
@@ -224,7 +224,7 @@ class AsyncMessagesResource(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,
     ) -> MessageListResponse:
         """
         Retrieve messages for a specific conversation, including tool calls made by the

telnyx/resources/ai/embeddings/buckets.py

@@ -4,7 +4,7 @@ from __future__ import annotations
 
 import httpx
 
-from ...._types import NOT_GIVEN, Body, Query, Headers, NoneType, NotGiven
+from ...._types import Body, Query, Headers, NoneType, NotGiven, not_given
 from ...._compat import cached_property
 from ...._resource import SyncAPIResource, AsyncAPIResource
 from ...._response import (
@@ -49,7 +49,7 @@ class BucketsResource(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,
     ) -> BucketRetrieveResponse:
         """
         Get all embedded files for a given user bucket, including their processing
@@ -82,7 +82,7 @@ class BucketsResource(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,
     ) -> BucketListResponse:
         """Get all embedding buckets for a user."""
         return self._get(
@@ -102,7 +102,7 @@ class BucketsResource(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:
         """
         Deletes an entire bucket's embeddings and disables the bucket for AI-use,
@@ -158,7 +158,7 @@ class AsyncBucketsResource(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,
     ) -> BucketRetrieveResponse:
         """
         Get all embedded files for a given user bucket, including their processing
@@ -191,7 +191,7 @@ class AsyncBucketsResource(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,
     ) -> BucketListResponse:
         """Get all embedding buckets for a user."""
         return await self._get(
@@ -211,7 +211,7 @@ class AsyncBucketsResource(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:
         """
         Deletes an entire bucket's embeddings and disables the bucket for AI-use,

telnyx/resources/ai/embeddings/embeddings.py

@@ -2,7 +2,6 @@
 
 from __future__ import annotations
 
-from typing import List
 from typing_extensions import Literal
 
 import httpx
@@ -15,7 +14,7 @@ from .buckets import (
     BucketsResourceWithStreamingResponse,
     AsyncBucketsResourceWithStreamingResponse,
 )
-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 (
@@ -68,16 +67,16 @@ class EmbeddingsResource(SyncAPIResource):
         self,
         *,
         bucket_name: str,
-        document_chunk_overlap_size: int | NotGiven = NOT_GIVEN,
-        document_chunk_size: int | NotGiven = NOT_GIVEN,
-        embedding_model: Literal["thenlper/gte-large", "intfloat/multilingual-e5-large"] | NotGiven = NOT_GIVEN,
-        loader: Literal["default", "intercom"] | NotGiven = NOT_GIVEN,
+        document_chunk_overlap_size: int | Omit = omit,
+        document_chunk_size: int | Omit = omit,
+        embedding_model: Literal["thenlper/gte-large", "intfloat/multilingual-e5-large"] | Omit = omit,
+        loader: Literal["default", "intercom"] | 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,
     ) -> EmbeddingResponse:
         """Perform embedding on a Telnyx Storage Bucket using the a embedding model.
 
@@ -151,7 +150,7 @@ class EmbeddingsResource(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,
     ) -> EmbeddingRetrieveResponse:
         """Check the status of a current embedding task.
 
@@ -186,13 +185,13 @@ class EmbeddingsResource(SyncAPIResource):
     def list(
         self,
         *,
-        status: List[str] | NotGiven = NOT_GIVEN,
+        status: SequenceNotStr[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,
     ) -> EmbeddingListResponse:
         """
         Retrieve tasks for the user that are either `queued`, `processing`, `failed`,
@@ -227,13 +226,13 @@ class EmbeddingsResource(SyncAPIResource):
         *,
         bucket_name: str,
         query: str,
-        num_of_docs: int | NotGiven = NOT_GIVEN,
+        num_of_docs: 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,
     ) -> EmbeddingSimilaritySearchResponse:
         """
         Perform a similarity search on a Telnyx Storage Bucket, returning the most
@@ -285,7 +284,7 @@ class EmbeddingsResource(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,
     ) -> EmbeddingResponse:
         """
         Embed website content from a specified URL, including child pages up to 5 levels
@@ -353,16 +352,16 @@ class AsyncEmbeddingsResource(AsyncAPIResource):
         self,
         *,
         bucket_name: str,
-        document_chunk_overlap_size: int | NotGiven = NOT_GIVEN,
-        document_chunk_size: int | NotGiven = NOT_GIVEN,
-        embedding_model: Literal["thenlper/gte-large", "intfloat/multilingual-e5-large"] | NotGiven = NOT_GIVEN,
-        loader: Literal["default", "intercom"] | NotGiven = NOT_GIVEN,
+        document_chunk_overlap_size: int | Omit = omit,
+        document_chunk_size: int | Omit = omit,
+        embedding_model: Literal["thenlper/gte-large", "intfloat/multilingual-e5-large"] | Omit = omit,
+        loader: Literal["default", "intercom"] | 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,
     ) -> EmbeddingResponse:
         """Perform embedding on a Telnyx Storage Bucket using the a embedding model.
 
@@ -436,7 +435,7 @@ class AsyncEmbeddingsResource(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,
     ) -> EmbeddingRetrieveResponse:
         """Check the status of a current embedding task.
 
@@ -471,13 +470,13 @@ class AsyncEmbeddingsResource(AsyncAPIResource):
     async def list(
         self,
         *,
-        status: List[str] | NotGiven = NOT_GIVEN,
+        status: SequenceNotStr[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,
     ) -> EmbeddingListResponse:
         """
         Retrieve tasks for the user that are either `queued`, `processing`, `failed`,
@@ -512,13 +511,13 @@ class AsyncEmbeddingsResource(AsyncAPIResource):
         *,
         bucket_name: str,
         query: str,
-        num_of_docs: int | NotGiven = NOT_GIVEN,
+        num_of_docs: 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,
     ) -> EmbeddingSimilaritySearchResponse:
         """
         Perform a similarity search on a Telnyx Storage Bucket, returning the most
@@ -570,7 +569,7 @@ class AsyncEmbeddingsResource(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,
     ) -> EmbeddingResponse:
         """
         Embed website content from a specified URL, including child pages up to 5 levels