[VoiceLive] Release 1.0.0b2 (#42946)

Co-authored-by: Xiting Zhang <[email protected]>

Author: xitzhang

sdk/ai/azure-ai-voicelive/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Release History
 
-## 1.0.0b2 (Unreleased)
+## 1.0.0b2 (2025-09-10)
 
 ### Features Added
 

sdk/ai/azure-ai-voicelive/azure/ai/voicelive/_patch.py

@@ -8,18 +8,32 @@
 
 Follow our quickstart for examples: https://aka.ms/azsdk/python/dpcodegen/python/customize
 """
+import sys
 import json
 import logging
 from contextlib import AbstractContextManager
 from urllib.parse import parse_qs, urlencode, urlparse, urlunparse
 
-try:  # Python 3.11+
-    from typing import NotRequired  # type: ignore[attr-defined]
-except Exception:  # Python <=3.10
-    from typing_extensions import NotRequired
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Dict,
+    Iterator,
+    List,
+    Mapping,
+    Optional,
+    Sequence,
+    Tuple,
+    Union,
+    cast,
+)
 
-from typing import TYPE_CHECKING, Optional, Mapping, Sequence, Tuple, Union, Iterator, Any, Dict, List, cast
+# === Third-party ===
 from typing_extensions import TypedDict
+from azure.core.credentials import AzureKeyCredential, TokenCredential
+from azure.core.exceptions import AzureError
+
+# === Local ===
 from azure.ai.voicelive.models._models import (
     ClientEventConversationItemCreate,
     ClientEventConversationItemDelete,
@@ -34,20 +48,26 @@
     ConversationRequestItem,
     ResponseCreateParams,
 )
-from azure.core.credentials import AzureKeyCredential, TokenCredential
-from azure.core.exceptions import AzureError
 from .models import ClientEvent, RequestSession, ServerEvent
 
+# === Conditional typing/runtime ===
 if TYPE_CHECKING:
     from websockets.typing import Subprotocol as WSSubprotocol  # exact type for checkers
 else:
     try:
         from websockets.typing import Subprotocol as WSSubprotocol  # runtime if available
     except Exception:
-
         class WSSubprotocol(str):  # fallback, keeps runtime simple
             pass
 
+if TYPE_CHECKING:
+    # Not imported at runtime; only for type checkers (mypy/pyright).
+    from websockets.sync.client import ClientConnection as _WSClientConnection
+
+if sys.version_info >= (3, 11):
+    from typing import NotRequired  # noqa: F401
+else:
+    from typing_extensions import NotRequired  # noqa: F401
 
 __all__: List[str] = [
     "connect",
@@ -492,7 +512,14 @@ class VoiceLiveConnection:
     :vartype transcription_session: ~azure.ai.voicelive.TranscriptionSessionResource
     """
 
-    def __init__(self, connection) -> None:
+    session: SessionResource
+    response: ResponseResource
+    input_audio_buffer: InputAudioBufferResource
+    conversation: ConversationResource
+    output_audio_buffer: OutputAudioBufferResource
+    transcription_session: TranscriptionSessionResource
+
+    def __init__(self, connection: "_WSClientConnection") -> None:
         """Initialize a VoiceLiveConnection.
 
         :param connection: The underlying WebSocket connection.

sdk/ai/azure-ai-voicelive/azure/ai/voicelive/aio/_patch.py

@@ -7,19 +7,14 @@
 
 Follow our quickstart for examples: https://aka.ms/azsdk/python/dpcodegen/python/customize
 """
+import sys
 import json
 import logging
 from contextlib import AbstractAsyncContextManager
 from urllib.parse import urlparse, urlunparse, urlencode, parse_qs
-
-# pylint: disable=ungrouped-imports
-try:  # Python 3.11+
-    from typing import NotRequired  # type: ignore[attr-defined]
-except ImportError:  # Python <=3.10
-    from typing_extensions import NotRequired
-# pylint: enable=ungrouped-imports
-
 from typing import Any, Dict, List, Mapping, Optional, Union, AsyncIterator, cast
+
+# === Third-party ===
 from typing_extensions import TypedDict
 import aiohttp
 from azure.ai.voicelive.models._models import (
@@ -38,9 +33,16 @@
 )
 from azure.core.credentials import AzureKeyCredential, TokenCredential
 from azure.core.pipeline import policies
+
+# === Local ===
 from ..models import ClientEvent, ServerEvent, RequestSession
 from .._patch import ConnectionError, ConnectionClosed
 
+if sys.version_info >= (3, 11):
+    from typing import NotRequired  # noqa: F401
+else:
+    from typing_extensions import NotRequired  # noqa: F401
+
 __all__: List[str] = [
     "connect",
     "WebsocketConnectionOptions",
@@ -400,6 +402,16 @@ class VoiceLiveConnection:
     :vartype transcription_session: ~azure.ai.voicelive.aio.TranscriptionSessionResource
     """
 
+    _client_session: aiohttp.ClientSession
+    _connection: aiohttp.ClientWebSocketResponse
+
+    session: "SessionResource"
+    response: "ResponseResource"
+    input_audio_buffer: "InputAudioBufferResource"
+    conversation: "ConversationResource"
+    output_audio_buffer: "OutputAudioBufferResource"
+    transcription_session: "TranscriptionSessionResource"
+
     def __init__(self, client_session: aiohttp.ClientSession, ws: aiohttp.ClientWebSocketResponse) -> None:
         """Initialize a VoiceLiveConnection instance.
 

sdk/ai/azure-ai-voicelive/azure/ai/voicelive/models/_models.py

@@ -3317,7 +3317,7 @@ def __init__(self, *args: Any, **kwargs: Any) -> None:
         super().__init__(*args, **kwargs)
 
     @classmethod
-    def deserialize(cls, payload: dict) -> "ServerEvent":
+    def deserialize(cls, payload: dict[str, Any]) -> "ServerEvent":
         # public, linter-friendly entrypoint
         # pylint: disable-next=protected-access
         return cls._deserialize(payload, [])

sdk/ai/azure-ai-voicelive/pyproject.toml

@@ -23,8 +23,8 @@ keywords = ["azure", "azure sdk", "voice", "voicelive", "realtime", "websocket",
 
 dependencies = [
   "isodate>=0.6.1",
-  "azure-core>=1.35.1",                       # bump if you rely on 1.35.1
-  "typing-extensions>=4.6.0; python_version < '3.11'",
+  "azure-core>=1.35.0",
+  "typing-extensions>=4.6.0",
 ]
 
 dynamic = ["version", "readme"]
@@ -60,4 +60,7 @@ readme = { file = ["README.md", "CHANGELOG.md"], content-type = "text/markdown"
 include = ["azure.ai.voicelive", "azure.ai.voicelive.*"]
 
 [tool.setuptools.package-data]
-"azure.ai.voicelive" = ["py.typed"]
+"azure.ai.voicelive" = ["py.typed"]
+
+[tool.azure-sdk-build]
+verifytypes = false