dial-agentframework 0.19.2__tar.gz → 0.20.0__tar.gz

{dial_agentframework-0.19.2 → dial_agentframework-0.20.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: dial-agentframework
-Version: 0.19.2
+Version: 0.20.0
 Summary: Official Dial tools for the Microsoft Agent Framework — phone numbers, SMS, OTP, and voice calls
 Requires-Python: >=3.11
 Requires-Dist: agent-framework-core>=1.0

{dial_agentframework-0.19.2 → dial_agentframework-0.20.0}/dial_agentframework/tools.py

@@ -115,7 +115,8 @@ def set_number_properties_tool(client: DialClient) -> FunctionTool:
         description=(
             "Update a Dial phone number's properties: its inbound instruction (the system "
             "prompt its AI voice agent uses on inbound calls), its nickname, and/or whether "
-            "calling is switched on at all (calling_enabled). "
+            "calling is switched on at all (calling_enabled) or forwards inbound calls to "
+            "another phone (forward_to). "
             "On iMessage numbers you can also set the display identity (first/last name "
             "and avatar photo) shown to recipients. Provide at least one."
         ),
@@ -173,6 +174,12 @@ def set_number_properties_tool(client: DialClient) -> FunctionTool:
             "the number is unaffected. Takes effect on the next call — a call already in "
             "progress is not ended. Omit to leave it unchanged.",
         ] = None,
+        forward_to: Annotated[
+            Optional[str],
+            "Forward inbound calls to this phone number (E.164) instead of having the AI "
+            "voice agent answer; the call ends if that phone is busy or doesn't answer. "
+            "Pass an empty string to stop forwarding. Omitted leaves it unchanged.",
+        ] = None,
     ) -> str:
         kwargs: dict = {}
         if inbound_instruction is not None:
@@ -199,17 +206,21 @@ def set_number_properties_tool(client: DialClient) -> FunctionTool:
         # False is a real value here; only None means "leave unchanged".
         if calling_enabled is not None:
             kwargs["calling_enabled"] = calling_enabled
+        # Empty string stops forwarding (sent as null); None means "leave unchanged".
+        if forward_to is not None:
+            kwargs["forward_to"] = forward_to or None
         if not kwargs:
             return (
                 "Provide at least one of inbound_instruction, inbound_voice_gender, "
                 "inbound_language, nickname, max_call_duration_seconds, calling_enabled, "
-                "first_name, last_name, or avatar_url."
+                "forward_to, first_name, last_name, or avatar_url."
             )
         number = await client.set_number_properties(number_id, **kwargs)
         nick = f' | nickname: "{number.nickname}"' if number.nickname else ""
         # Reported only when off, so a messaging-only line isn't a silent surprise.
         calling = "" if number.calling_enabled else " | calling: off (messaging only)"
-        return f"Updated {number.number} (id: {number.id}){nick}{calling}"
+        fwd = f" | forwarding calls to {number.forward_to}" if number.forward_to else ""
+        return f"Updated {number.number} (id: {number.id}){nick}{calling}{fwd}"
 
     return set_number_properties
 

{dial_agentframework-0.19.2 → dial_agentframework-0.20.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "dial-agentframework"
-version = "0.19.2"
+version = "0.20.0"
 description = "Official Dial tools for the Microsoft Agent Framework — phone numbers, SMS, OTP, and voice calls"
 readme = "README.md"
 requires-python = ">=3.11"

{dial_agentframework-0.19.2 → dial_agentframework-0.20.0}/tests/test_tools.py

@@ -35,6 +35,7 @@ class _FakeNumber:
     country = "US"
     nickname = None
     calling_enabled = True
+    forward_to = None
 
 
 class FakeClient:
@@ -297,6 +298,34 @@ def test_set_number_properties_omits_unprovided_name_fields():
     assert kwargs["nickname"] == "Support"
 
 
+def test_set_number_properties_forwards_forward_to():
+    client = FakeClient(set_number_properties=_FakeNumber())
+    tool = set_number_properties_tool(client)
+    _run(tool, number_id="pn_9", forward_to="+18005550100")
+
+    assert client.calls["set_number_properties"]["kwargs"]["forward_to"] == "+18005550100"
+
+
+def test_set_number_properties_empty_forward_to_stops_forwarding():
+    # An empty string is sent to the SDK as None — an explicit null that stops
+    # forwarding — rather than being swallowed like an omitted argument.
+    client = FakeClient(set_number_properties=_FakeNumber())
+    tool = set_number_properties_tool(client)
+    _run(tool, number_id="pn_9", forward_to="")
+
+    kwargs = client.calls["set_number_properties"]["kwargs"]
+    assert "forward_to" in kwargs
+    assert kwargs["forward_to"] is None
+
+
+def test_set_number_properties_omits_unprovided_forward_to():
+    client = FakeClient(set_number_properties=_FakeNumber())
+    tool = set_number_properties_tool(client)
+    _run(tool, number_id="pn_9", nickname="Support")
+
+    assert "forward_to" not in client.calls["set_number_properties"]["kwargs"]
+
+
 def test_make_call_passes_idempotency_key():
     client = FakeClient(make_call=_FakeCall())
     tool = make_call_tool(client)

{dial_agentframework-0.19.2 → dial_agentframework-0.20.0}/uv.lock

@@ -345,7 +345,7 @@ wheels = [
 
 [[package]]
 name = "dial-agentframework"
-version = "0.19.2"
+version = "0.20.0"
 source = { editable = "." }
 dependencies = [
     { name = "agent-framework-core" },
@@ -368,7 +368,7 @@ dev = [{ name = "pytest", specifier = ">=8" }]
 
 [[package]]
 name = "dial-sdk"
-version = "0.31.0"
+version = "0.32.0"
 source = { editable = "../sdk-python" }
 dependencies = [
     { name = "httpx" },