avartha-python-sdk 0.0.4__py3-none-any.whl → 0.0.6__py3-none-any.whl

avartha/_config.py

@@ -8,12 +8,28 @@ from urllib.parse import urlsplit, urlunsplit
 
 import httpx
 
-Tier = Literal["serverless", "dedicated"]
+Tier = Literal["serverless"]
 DEFAULT_BASE_URL = "https://platform.preview.avartha.ai"
 
 
 class ConfigurationError(ValueError):
-    """Missing credentials or an invalid service URL."""
+    """Missing credentials, an unsupported tier, or an invalid service URL."""
+
+
+def validate_tier(tier: Tier) -> None:
+    if tier != "serverless":
+        raise ConfigurationError(
+            "Only tier='serverless' is supported. Dedicated capacity is unavailable."
+        )
+
+
+def reject_dedicated_url(value: str) -> str:
+    """Reject the dedicated inference route, including behind a proxy prefix."""
+    if re.search(r"(?:^|/)inference/dedicated(?:/|$)", httpx.URL(value).path):
+        raise ConfigurationError(
+            "Dedicated capacity is unavailable. Use a serverless inference URL."
+        )
+    return value
 
 
 def api_key(value: str | None) -> str:
@@ -41,12 +57,13 @@ def http_url(value: str) -> str:
             or (parts.port is not None and not 1 <= parts.port <= 65535)
         ):
             raise ValueError("Invalid URL authority")
-        return str(httpx.URL(value)).rstrip("/")
+        normalized = str(httpx.URL(value)).rstrip("/")
     except (ValueError, httpx.InvalidURL):
         raise ConfigurationError(
             "Use an absolute http(s) base URL without credentials, query, fragment, "
             "whitespace, or backslashes."
         ) from None
+    return reject_dedicated_url(normalized)
 
 
 def platform_url(value: str | None = None) -> str:
@@ -60,20 +77,18 @@ def platform_url(value: str | None = None) -> str:
 
 
 def openai_url(root: str | None = None, tier: Tier = "serverless") -> str:
-    if tier not in {"serverless", "dedicated"}:
-        raise ConfigurationError("tier must be 'serverless' or 'dedicated'.")
-    return f"{platform_url(root)}/inference/{tier}/openai/v1"
+    validate_tier(tier)
+    return f"{platform_url(root)}/inference/serverless/openai/v1"
 
 
 def elevenlabs_url(
     value: str | None = None, *, root: str | None = None, tier: Tier = "serverless"
 ) -> str:
+    validate_tier(tier)
     override = value if value is not None else os.getenv("AVARTHA_ELEVENLABS_BASE_URL")
     if override is not None:
         return http_url(override)
-    if tier not in {"serverless", "dedicated"}:
-        raise ConfigurationError("tier must be 'serverless' or 'dedicated'.")
-    return f"{platform_url(root)}/inference/{tier}/elevenlabs"
+    return f"{platform_url(root)}/inference/serverless/elevenlabs"
 
 
 def websocket_url(value: str) -> str:
@@ -147,4 +162,4 @@ def websocket_override(value: str) -> str:
             "websocket_base_url must be the service base before /realtime; "
             "the SDK appends /realtime when connecting."
         )
-    return not_vendor_host(normalized, field="websocket_base_url")
+    return not_vendor_host(reject_dedicated_url(normalized), field="websocket_base_url")

avartha/_realtime_asr.py

@@ -7,7 +7,7 @@ import json
 import logging
 from collections.abc import Callable
 from enum import Enum
-from typing import Any, Required, TypedDict, cast
+from typing import Any, Literal, Required, TypedDict, cast
 
 from websockets.asyncio.client import ClientConnection
 
@@ -45,6 +45,7 @@ class RealtimeEvents(str, Enum):  # noqa: UP042 - preserve the upstream str() re
     COMMITTED_TRANSCRIPT = "committed_transcript"
     COMMITTED_TRANSCRIPT_WITH_TIMESTAMPS = "committed_transcript_with_timestamps"
     COMMITTED_TRANSCRIPT_ENTITIES = "committed_transcript_entities"
+    WARNING = "warning"
     ERROR = "error"
     AUTH_ERROR = "auth_error"
     QUOTA_EXCEEDED = "quota_exceeded"
@@ -69,9 +70,15 @@ class _SharedOptions(TypedDict, total=False):
     vad_threshold: float
     min_speech_duration_ms: int
     min_silence_duration_ms: int
+    # Avartha turn controls require VAD; availability is validated by the server.
+    turn_model: Literal["silence", "smart_turn_v3"]
+    turn_threshold: float
     language_code: str
     secondary_languages: list[str]
     include_timestamps: bool
+    # Avartha extensions: diarization also requires include_timestamps=True.
+    diarize: bool
+    include_logprobs: bool
     include_language_detection: bool
     keyterms: list[str]
     no_verbatim: bool
@@ -105,6 +112,7 @@ _NON_ERRORS = {
     RealtimeEvents.COMMITTED_TRANSCRIPT,
     RealtimeEvents.COMMITTED_TRANSCRIPT_WITH_TIMESTAMPS,
     RealtimeEvents.COMMITTED_TRANSCRIPT_ENTITIES,
+    RealtimeEvents.WARNING,
     RealtimeEvents.ERROR,
 }
 

avartha/_speech_http.py

@@ -5,7 +5,7 @@ import email.utils
 import json
 import random
 import time
-from collections.abc import Mapping
+from collections.abc import Callable, Mapping
 from datetime import UTC, datetime
 from typing import Any
 from urllib.parse import quote
@@ -38,6 +38,9 @@ class HttpResponse[T]:
     def close(self) -> None:
         self._response.close()
 
+    def map_data[U](self, transform: Callable[[T], U]) -> "HttpResponse[U]":
+        return HttpResponse(self._response, transform(self.data))
+
 
 class AsyncHttpResponse[T]:
     """Async variant of the typed HTTP response wrapper."""
@@ -57,6 +60,9 @@ class AsyncHttpResponse[T]:
     async def close(self) -> None:
         await self._response.aclose()
 
+    def map_data[U](self, transform: Callable[[T], U]) -> "AsyncHttpResponse[U]":
+        return AsyncHttpResponse(self._response, transform(self.data))
+
 
 def segment(value: str) -> str:
     if value in {".", ".."}:

avartha/_speech_resources.py

@@ -8,6 +8,7 @@ an Avartha extension. Transport and credentials are handled inside the SDK.
 import builtins
 from collections.abc import Sequence
 
+from ._exceptions import ApiError
 from ._speech_config import RequestOptions
 from ._speech_http import (
     AsyncHttpResponse,
@@ -17,7 +18,42 @@ from ._speech_http import (
     segment,
 )
 from .types.speech import GetVoicesResponse, GetVoicesV2Response, Model, Voice, VoiceSettings
-from .types.speech_language import SpeechLanguageList
+from .types.speech_language import SpeechLanguage, SpeechLanguageList
+
+
+def _model_languages(models: list[Model], model_id: str) -> SpeechLanguageList:
+    matches = [model for model in models if model.model_id == model_id]
+    if len(matches) != 1:
+        raise ApiError(body=f"ASR model {model_id!r} is missing or ambiguous in the model catalog")
+    model = matches[0]
+    model_type = getattr(model, "model_type", None)
+    # Direct ASR runtimes expose vendor capabilities without Platform's type tag.
+    is_asr = model_type == "speech_to_text" or (
+        model_type is None
+        and model.can_do_text_to_speech is False
+        and model.can_do_voice_conversion is False
+    )
+    if not is_asr:
+        raise ApiError(body=f"Model {model_id!r} is not identified as ASR in the model catalog")
+    languages = model.languages
+    if languages is None:
+        raise ApiError(body=f"Language metadata is unavailable for ASR model {model_id!r}")
+    if not isinstance(languages, list) or any(
+        not isinstance(getattr(language, "language_id", None), str)
+        or not language.language_id
+        or not isinstance(getattr(language, "name", None), str)
+        or not language.name
+        for language in languages
+    ):
+        raise ApiError(body=f"Invalid language metadata for ASR model {model_id!r}")
+    return SpeechLanguageList(
+        object="list",
+        model=model_id,
+        language_hints_supported=bool(languages),
+        languages=[
+            SpeechLanguage(code=language.language_id, name=language.name) for language in languages
+        ],
+    )
 
 
 class RawVoices:
@@ -137,12 +173,13 @@ class RawLanguages:
     def list(
         self, *, model_id: str, request_options: RequestOptions | None = None
     ) -> HttpResponse[SpeechLanguageList]:
-        return self._client.get(
-            "v1/speech-to-text/languages",
-            SpeechLanguageList,
-            params={"model_id": model_id},
+        response = self._client.get(
+            "v1/models",
+            builtins.list[Model],
+            params={},
             request_options=request_options,
         )
+        return response.map_data(lambda models: _model_languages(models, model_id))
 
 
 class Voices:
@@ -361,12 +398,13 @@ class AsyncRawLanguages:
     async def list(
         self, *, model_id: str, request_options: RequestOptions | None = None
     ) -> AsyncHttpResponse[SpeechLanguageList]:
-        return await self._client.get(
-            "v1/speech-to-text/languages",
-            SpeechLanguageList,
-            params={"model_id": model_id},
+        response = await self._client.get(
+            "v1/models",
+            builtins.list[Model],
+            params={},
             request_options=request_options,
         )
+        return response.map_data(lambda models: _model_languages(models, model_id))
 
 
 class AsyncVoices:

avartha/client.py

@@ -16,6 +16,12 @@ class Avartha:
 
     openai_options, elevenlabs_options and control_options are forwarded to
     their respective constructors (for timeouts, transports, retry settings).
+
+    Live STT through elevenlabs.speech_to_text.realtime remains asynchronous.
+    Await connect(), send(), commit(), and the transcription connection's close().
+    Register callbacks with on() without awaiting. Use AsyncAvartha for an async
+    application.
+    Close live sessions separately before closing this client.
     """
 
     def __init__(
@@ -30,6 +36,9 @@ class Avartha:
         elevenlabs_options: dict[str, Any] | None = None,
         control_options: dict[str, Any] | None = None,
     ) -> None:
+        _config.validate_tier(tier)
+        for options in (openai_options, elevenlabs_options):
+            _config.validate_tier((options or {}).get("tier", "serverless"))
         key, root = _config.api_key(api_key), _config.platform_url(base_url)
         self._elevenlabs_base_url = _config.elevenlabs_url(
             elevenlabs_base_url, root=root, tier=tier
@@ -99,6 +108,9 @@ class AsyncAvartha:
         elevenlabs_options: dict[str, Any] | None = None,
         control_options: dict[str, Any] | None = None,
     ) -> None:
+        _config.validate_tier(tier)
+        for options in (openai_options, elevenlabs_options):
+            _config.validate_tier((options or {}).get("tier", "serverless"))
         key, root = _config.api_key(api_key), _config.platform_url(base_url)
         self._elevenlabs_base_url = _config.elevenlabs_url(
             elevenlabs_base_url, root=root, tier=tier

avartha/elevenlabs.py

@@ -45,6 +45,7 @@ class _Client:
         environment: str | Enum | None = None,
         websocket_limits: WebSocketLimits | None = None,
     ) -> None:
+        _config.validate_tier(tier)
         self.api_key = _config.api_key(api_key)
         if base_url is None and environment is not None:
             base_url = str(environment.value) if isinstance(environment, Enum) else environment

avartha/openai.py

@@ -121,6 +121,7 @@ class _Client:
         _enforce_credentials: bool = True,
         tier: Tier = "serverless",
     ) -> None:
+        _config.validate_tier(tier)
         if data_residency is not None:
             raise ConfigurationError(
                 "data_residency selects a vendor host; use an Avartha base_url."

avartha/types/realtime/realtime_reasoning_effort.py

@@ -3,4 +3,6 @@
 from typing import Literal, TypeAlias
 
 __all__ = ["RealtimeReasoningEffort"]
-RealtimeReasoningEffort: TypeAlias = Literal["minimal", "low", "medium", "high", "xhigh"]
+RealtimeReasoningEffort: TypeAlias = Literal[
+    "none", "minimal", "low", "medium", "high", "xhigh", "max"
+]

{avartha_python_sdk-0.0.4.dist-info → avartha_python_sdk-0.0.6.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: avartha-python-sdk
-Version: 0.0.4
+Version: 0.0.6
 Summary: Python clients for Avartha Realtime text, streaming speech, and platform management
 Author-email: "Avartha Inc." <team@avartha.ai>
 License-Expression: LicenseRef-Avartha-Proprietary
@@ -47,9 +47,10 @@ export AVARTHA_API_KEY='avk_...'
 export AVARTHA_BASE_URL='https://platform.preview.avartha.ai'
 ```
 
-Clients default to the preview platform and the `serverless` tier. Set
-`AVARTHA_BASE_URL` for another environment or `tier="dedicated"` for dedicated
-inference. Use model and voice IDs available to your workspace and tier.
+Clients default to the preview platform and support only serverless inference.
+Set `AVARTHA_BASE_URL` for another environment. Use model and voice IDs available
+to your workspace. Unsupported tier values and dedicated inference URLs raise
+`ConfigurationError` locally before any request.
 
 ## Discover models
 
@@ -107,7 +108,7 @@ Inference consumes credits.
 | Multi-context TTS | `ElevenLabs` / `AsyncElevenLabs`: `text_to_speech.connect_multi_context` |
 | Realtime ASR | `await client.speech_to_text.realtime.connect(...)` on either speech client |
 | Speech discovery | Speech clients: models, voices, voice settings, ASR languages |
-| Workspaces, members, invitations, endpoints | `Control` / `AsyncControl` |
+| Workspaces, members, invitations | `Control` / `AsyncControl` |
 | Combined inference and management | `Avartha` / `AsyncAvartha` |
 
 Managed inference uses WebSockets; Chat Completions, Responses, HTTP TTS,

{avartha_python_sdk-0.0.4.dist-info → avartha_python_sdk-0.0.6.dist-info}/RECORD

@@ -1,27 +1,27 @@
 avartha/__init__.py,sha256=fusR2DiiRSAaZCIhLrxRdyJWjA8p9uL4PAVGXbArjXM,2821
-avartha/_config.py,sha256=IqEdSm8MPQOXThcs_ew98Eys4R7d4l-5ZYAiPzEm29Y,5880
+avartha/_config.py,sha256=mzaHiqYH_7N4okLijiRbJlCNyxvZn4Ni_A_OAZDtOTA,6314
 avartha/_exceptions.py,sha256=_QY7SEw2nqyOz3pNxDWi40GW1xqB3EZxJ0t4iJ-YBpQ,1588
 avartha/_http_errors.py,sha256=gU8eapqYcI7Q3M8lAxwVH-qwz-TnQf2loBThFKG0ka8,406
 avartha/_models.py,sha256=KB4PeFvktbSOKbT-qMX5tjsExEg9cwufZ3ourx8GcVI,7331
 avartha/_openai_http.py,sha256=8jA9ywFi4OqrAwYn9MThlgiEDXkao2Thja6VpX8fikU,10149
 avartha/_openai_http_errors.py,sha256=MRZJMddDPVFMEo_KOlwsmkKXMZB6H39tLut5KyDFRaI,2123
 avartha/_pacing.py,sha256=31ajT2i7ChcQJBZJCBwUDrTiMZrlSv6ziQwgqGIKvlc,1807
-avartha/_realtime_asr.py,sha256=nLqDGptSL46mjESDqQVHkcu5MtgQYBv1GIl1tRK2L44,11695
+avartha/_realtime_asr.py,sha256=Cdy8xDuU4N6c-VCZof7UmVtkFsCq4UlSgx_rw1y88Mc,12038
 avartha/_realtime_openai.py,sha256=Su9xfsYmYCIMPwxBKuVbQp_tWoC9lUI8gidmexGmIow,23226
 avartha/_realtime_resources.py,sha256=rZj8hBYuLP9kTX56hhXTGE8R3crW_Wfmn46VY_dL3TM,7489
 avartha/_realtime_tts.py,sha256=j6X2REqTNr2een-G47K7248k29kamr113EG8CrmrXPA,33763
 avartha/_sentinels.py,sha256=eX9pg8L8DMWOLrNLfJKWjcFHC5GZO0I_snULCum0ehg,433
 avartha/_speech_config.py,sha256=jL0M8Z6MGXzfgf3Lm7QMMEKDtVXCW5-jrqz5WEtu9g4,1781
-avartha/_speech_http.py,sha256=LNcHPLleuLDQNfMIlUD-ijua5h4VPhqXAmcDrXB8Cdg,10632
-avartha/_speech_resources.py,sha256=61DKhTnz_bpOTjY_CpeR0mXs9ui9-XeaYgpSDNk_NpE,16954
+avartha/_speech_http.py,sha256=DXTqPOzLsGsPnyvuuokmfN0eT9OScWGMZj1iJm6oWPc,10940
+avartha/_speech_resources.py,sha256=zBJHkQkllmWG_bmTIhwmjz9Nf7w4JMNkKJimnaIL3_4,18628
 avartha/_unsupported.py,sha256=qrbsxi2SL6co5M2uLs4fTVOoISuUm58khoayeL22gPE,637
 avartha/_websocket.py,sha256=9R05huh1n8spuyg1n_aIJN0Uk_kLG7BbNPD88wogIKY,855
 avartha/_ws_state.py,sha256=Im2W-UJtCBimYU5vlYBbVRL06DGwuw0Q5ufy4sSGIeM,5049
-avartha/client.py,sha256=jm4CYnzORxtWn2LiVIfBff53dNsUiJjuFb6V01lxBTQ,5006
+avartha/client.py,sha256=vNZmmWWdGhSxdwb-lqBbioP4DK4MpoUgFWLJfqR5zxo,5677
 avartha/control.py,sha256=jB7I4ccDBaVh2OMLZXhEeAsGNparMLURZQXnh-I__ss,23894
-avartha/elevenlabs.py,sha256=bZ0yoloj_I58CpeGe-UVQUdjUlQkGWXCx7qn017lXmQ,5426
+avartha/elevenlabs.py,sha256=tFugwzE8XKbQZsK7P6w6fGXGz76Udp5vt039uVwzOi8,5462
 avartha/errors.py,sha256=8HMwf2P4VXwk4tRC5ZwceVOUFkRD0wEu9Bn1gljIj0Y,1333
-avartha/openai.py,sha256=Xfdf12krOkQv_r8NmCHTfi9JluiethE_NDni-gN3jEI,11919
+avartha/openai.py,sha256=9xlmNdx0E2HWYUf5tEI1UbS82y7XerY1T76Jx7sQv18,11955
 avartha/pagination.py,sha256=_5qt1bAPKQiXjrHcD0J93yNpBKBhbTRzZfnL9WCUwMw,1471
 avartha/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 avartha/conversational_ai/__init__.py,sha256=Pc7h5OczniKnF54UvMYVILdU-pCXyZ9YnxtzggBc294,217
@@ -122,7 +122,7 @@ avartha/types/realtime/realtime_mcp_tool_execution_error_param.py,sha256=ESoZmAb
 avartha/types/realtime/realtime_mcphttp_error.py,sha256=LsYLVdqDZ4jUGvlUTpSdKAdgad73-0ls2tk4Z6M5nX8,269
 avartha/types/realtime/realtime_mcphttp_error_param.py,sha256=X1dGkZnFu8MQqQU78gvOLPHIWR0L7ZJKG_x7hb1zCPQ,370
 avartha/types/realtime/realtime_reasoning.py,sha256=5v3tvYRDDjnJTpT0amG9jLd1dxV2Qy7mAenDnhmDhTc,307
-avartha/types/realtime/realtime_reasoning_effort.py,sha256=ayokU5AgzVYViDq0nB7V0TBW_Ulbn5DTPKTdyjZK0n0,230
+avartha/types/realtime/realtime_reasoning_effort.py,sha256=LFk2Oyv60GonPWfBI7FM0MFrnTCviZWNWPey6aYcRK8,251
 avartha/types/realtime/realtime_reasoning_param.py,sha256=YIMK-W-iZq3-PqBQFw8nYC4dIrhDbQJtkRqjvmZuwY8,355
 avartha/types/realtime/realtime_response.py,sha256=mCQWWODuBHpEjQfWevtJ8BZ7lYmWxhhc415hWrMjGl8,1493
 avartha/types/realtime/realtime_response_create_audio_output.py,sha256=h7Y4MqXEViQdliq81eLn601kGEnxam5ZCaPWNeO4VHU,741
@@ -248,9 +248,9 @@ avartha/types/speech/voice_sharing_response.py,sha256=KRO9Rq80wTYV5of2bRrFTVJSDf
 avartha/types/speech/voice_sharing_response_category.py,sha256=0yFm6b7R4piHdNTdBWTQYKpNPxW8r2HJvnMdVpT7s5U,241
 avartha/types/speech/voice_sharing_state.py,sha256=8EBRbrRaDhUEap39kDXmt54AYeG172fnuBmRV1TSHP4,201
 avartha/types/speech/voice_verification_response.py,sha256=IL_Z1OTIiR9mvuaWzF9-GsL7pMRZ5fJeV_W3FfjLTTY,770
-avartha_python_sdk-0.0.4.dist-info/licenses/LICENSE,sha256=1ulXrK7aq7kBXX1scK6IiOgnbwqpmK6kWIB3CYznVG8,1135
-avartha_python_sdk-0.0.4.dist-info/licenses/THIRD_PARTY_NOTICES,sha256=R62M0553miTc6E42IVFLUIYkLFim_mf_Abq1lty0IaQ,13081
-avartha_python_sdk-0.0.4.dist-info/METADATA,sha256=czBiWHsr1vStz2ovwxvukAfTPzYZDqDdmdstwZvGm_g,5579
-avartha_python_sdk-0.0.4.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
-avartha_python_sdk-0.0.4.dist-info/top_level.txt,sha256=cj2kDXl33tO2IPWPduSTukcwozPnYKOsVUVE9QZRUr0,8
-avartha_python_sdk-0.0.4.dist-info/RECORD,,
+avartha_python_sdk-0.0.6.dist-info/licenses/LICENSE,sha256=1ulXrK7aq7kBXX1scK6IiOgnbwqpmK6kWIB3CYznVG8,1135
+avartha_python_sdk-0.0.6.dist-info/licenses/THIRD_PARTY_NOTICES,sha256=R62M0553miTc6E42IVFLUIYkLFim_mf_Abq1lty0IaQ,13081
+avartha_python_sdk-0.0.6.dist-info/METADATA,sha256=WVETx80YlFn1-OFO_CSQpGyMenSjNVrnQFD5Q-mNoPg,5633
+avartha_python_sdk-0.0.6.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+avartha_python_sdk-0.0.6.dist-info/top_level.txt,sha256=cj2kDXl33tO2IPWPduSTukcwozPnYKOsVUVE9QZRUr0,8
+avartha_python_sdk-0.0.6.dist-info/RECORD,,