voice-runtime 0.2.0__tar.gz → 0.3.0__tar.gz

{voice_runtime-0.2.0/voice_runtime.egg-info → voice_runtime-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: voice-runtime
-Version: 0.2.0
+Version: 0.3.0
 Summary: Provider-agnostic voice call runtime for telephony projects
 Author: Kasper Heikkinen, Sami Heikkinen
 License: MIT License

{voice_runtime-0.2.0 → voice_runtime-0.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "voice-runtime"
-version = "0.2.0"
+version = "0.3.0"
 description = "Provider-agnostic voice call runtime for telephony projects"
 readme = "README.md"
 license = { file = "LICENSE" }

{voice_runtime-0.2.0 → voice_runtime-0.3.0}/tests/test_twilio_call.py

@@ -158,6 +158,91 @@ class TestInitiateOutboundCall:
         mock_client.calls.create.assert_called_once()
 
 
+_REGION_ENV = {
+    "TWILIO_ACCOUNT_SID": "",
+    "TWILIO_AUTH_TOKEN": "",
+    "TWILIO_PHONE_NUMBER": "+15551234567",
+    "VOICE_STREAM_URL": "https://example.ngrok.io",
+}
+
+
+def _ie1_region():
+    from voice_runtime.transports.twilio_call import TwilioRegion
+
+    return TwilioRegion(
+        api_host="api.dublin.ie1.twilio.com",
+        account_sid="AC1",
+        auth=("SK1", "secret"),
+    )
+
+
+class TestInitiateOutboundCallRegion:
+    """An explicit region places the call with its own identity, no Auth Token."""
+
+    def test_region_uses_explicit_client_without_auth_token(self):
+        from voice_runtime.transports.twilio_call import initiate_outbound_call
+
+        mock_client = MagicMock()
+        mock_client.calls.create.return_value = MagicMock(sid="CA9")
+        region = _ie1_region()
+
+        with (
+            patch.dict("os.environ", _REGION_ENV, clear=False),
+            patch(
+                "voice_runtime.transports.twilio_call.build_explicit_twilio_client",
+                return_value=mock_client,
+            ) as build_explicit,
+            patch(
+                "voice_runtime.transports.twilio_call.build_twilio_client"
+            ) as build_ambient,
+        ):
+            sid = initiate_outbound_call("+358401234567", region=region)
+
+        assert sid == "CA9"
+        build_explicit.assert_called_once_with(region)
+        build_ambient.assert_not_called()
+        _, kwargs = mock_client.calls.create.call_args
+        assert kwargs["to"] == "+358401234567"
+        assert kwargs["from_"] == "+15551234567"
+        assert 'url="wss://example.ngrok.io/voice"' in kwargs["twiml"]
+
+    def test_region_still_requires_stream_url(self):
+        from voice_runtime.transports.twilio_call import initiate_outbound_call
+
+        env = {**_REGION_ENV, "VOICE_STREAM_URL": ""}
+        with (
+            patch.dict("os.environ", env, clear=False),
+            pytest.raises(RuntimeError, match="VOICE_STREAM_URL"),
+        ):
+            initiate_outbound_call("+358401234567", region=_ie1_region())
+
+    def test_region_still_requires_phone_number(self):
+        from voice_runtime.transports.twilio_call import initiate_outbound_call
+
+        env = {**_REGION_ENV, "TWILIO_PHONE_NUMBER": ""}
+        with (
+            patch.dict("os.environ", env, clear=False),
+            pytest.raises(RuntimeError, match="TWILIO_PHONE_NUMBER"),
+        ):
+            initiate_outbound_call("+358401234567", region=_ie1_region())
+
+    def test_region_is_revalidated(self):
+        from voice_runtime.transports.twilio_call import initiate_outbound_call
+
+        with (
+            patch.dict("os.environ", _REGION_ENV, clear=False),
+            pytest.raises(ValueError, match="Invalid Twilio API host"),
+        ):
+            initiate_outbound_call(
+                "+358401234567",
+                region={
+                    "api_host": "evil.example.com",
+                    "account_sid": "AC1",
+                    "auth": ("a", "b"),
+                },
+            )
+
+
 class TestHangupCall:
     """ninchat_voice NC-362: supervisor-side reap teardown rides this seam."""
 
@@ -184,7 +269,11 @@ class TestHangupCall:
         from voice_runtime.transports.twilio_call import hangup_call
 
         with (
-            patch.dict("os.environ", {"TWILIO_ACCOUNT_SID": "", "TWILIO_AUTH_TOKEN": ""}, clear=False),
+            patch.dict(
+                "os.environ",
+                {"TWILIO_ACCOUNT_SID": "", "TWILIO_AUTH_TOKEN": ""},
+                clear=False,
+            ),
             pytest.raises(RuntimeError, match="TWILIO_ACCOUNT_SID"),
         ):
             hangup_call("CA-x")

{voice_runtime-0.2.0 → voice_runtime-0.3.0}/voice_runtime/transports/twilio_call.py

@@ -84,17 +84,23 @@ def build_route_stream_xml(stream_url: str, route_token: str) -> str:
 </Response>""".strip()
 
 
-def initiate_outbound_call(phone: str) -> str:
+def initiate_outbound_call(phone: str, *, region: TwilioRegion | None = None) -> str:
     """Initiate an outbound Twilio call with Media Streams.
 
     Args:
         phone: Phone number to call (E.164 format).
+        region: Explicit routing and identity (e.g. an IE1 API key pair).
+            When given, the call is placed through that region and
+            TWILIO_ACCOUNT_SID/TWILIO_AUTH_TOKEN are not read. Without it,
+            the ambient Account Auth Token is used.
 
     Returns:
         call_sid from Twilio.
 
     Raises:
-        RuntimeError: If VOICE_STREAM_URL or Twilio credentials are missing.
+        RuntimeError: If VOICE_STREAM_URL, TWILIO_PHONE_NUMBER or, without
+            a region, the Twilio credentials are missing.
+        ValueError: If region is not a valid TwilioRegion.
     """
     account_sid, auth_token, phone_number, stream_url = _get_twilio_env()
 
@@ -102,15 +108,21 @@ def initiate_outbound_call(phone: str) -> str:
         raise RuntimeError(
             "Set VOICE_STREAM_URL to a public WebSocket URL (use ngrok for local dev)"
         )
-    if not account_sid or not auth_token:
-        raise RuntimeError("TWILIO_ACCOUNT_SID and TWILIO_AUTH_TOKEN required")
+    if region is None:
+        if not account_sid or not auth_token:
+            raise RuntimeError("TWILIO_ACCOUNT_SID and TWILIO_AUTH_TOKEN required")
+    else:
+        region = TwilioRegion.model_validate(region)
     if not phone_number:
         raise RuntimeError("TWILIO_PHONE_NUMBER required")
 
     twiml = build_stream_twiml(stream_url)
     logger.info("Initiating outbound call to %s", phone)
 
-    client = build_twilio_client(account_sid, auth_token)
+    if region is None:
+        client = build_twilio_client(account_sid, auth_token)
+    else:
+        client = build_explicit_twilio_client(region)
     call = client.calls.create(
         to=phone,
         from_=phone_number,

{voice_runtime-0.2.0 → voice_runtime-0.3.0/voice_runtime.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: voice-runtime
-Version: 0.2.0
+Version: 0.3.0
 Summary: Provider-agnostic voice call runtime for telephony projects
 Author: Kasper Heikkinen, Sami Heikkinen
 License: MIT License