avartha-python-sdk 0.0.4__py3-none-any.whl → 0.0.5__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/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.5.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: avartha-python-sdk
-Version: 0.0.4
+Version: 0.0.5
 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.5.dist-info}/RECORD

@@ -1,5 +1,5 @@
 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
@@ -17,11 +17,11 @@ avartha/_speech_resources.py,sha256=61DKhTnz_bpOTjY_CpeR0mXs9ui9-XeaYgpSDNk_NpE,
 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.5.dist-info/licenses/LICENSE,sha256=1ulXrK7aq7kBXX1scK6IiOgnbwqpmK6kWIB3CYznVG8,1135
+avartha_python_sdk-0.0.5.dist-info/licenses/THIRD_PARTY_NOTICES,sha256=R62M0553miTc6E42IVFLUIYkLFim_mf_Abq1lty0IaQ,13081
+avartha_python_sdk-0.0.5.dist-info/METADATA,sha256=H30kDxD_ubuCN9uf6E0sH4jhxeQlFK2g1EHcur57C7o,5633
+avartha_python_sdk-0.0.5.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+avartha_python_sdk-0.0.5.dist-info/top_level.txt,sha256=cj2kDXl33tO2IPWPduSTukcwozPnYKOsVUVE9QZRUr0,8
+avartha_python_sdk-0.0.5.dist-info/RECORD,,