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

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

@@ -1,10 +1,10 @@
 Metadata-Version: 2.5
 Name: dial-agentframework
-Version: 0.19.2
+Version: 0.21.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
-Requires-Dist: dial-sdk>=0.30.0
+Requires-Dist: dial-sdk>=0.33.0
 Description-Content-Type: text/markdown
 
 # dial-agentframework

{dial_agentframework-0.19.2 → dial_agentframework-0.21.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
 
@@ -288,7 +299,8 @@ def list_groups_tool(client: DialClient) -> FunctionTool:
         if not groups:
             return "No groups found."
         return "\n".join(
-            f"{g.id}: {g.name or '(unnamed)'} (since {g.created_at})" for g in groups
+            f"{g.id} ({g.channel}): {g.name or '(unnamed)'} (since {g.created_at})"
+            for g in groups
         )
 
     return list_groups

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

@@ -1,6 +1,6 @@
 [project]
 name = "dial-agentframework"
-version = "0.19.2"
+version = "0.21.0"
 description = "Official Dial tools for the Microsoft Agent Framework — phone numbers, SMS, OTP, and voice calls"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -8,7 +8,7 @@ dependencies = [
     # Core has `tool` + `FunctionTool` (all this package needs). Chat clients ship in
     # separate integration packages (agent-framework-openai, …) the user installs.
     "agent-framework-core>=1.0",
-    "dial-sdk>=0.30.0",
+    "dial-sdk>=0.33.0",
 ]
 
 [tool.uv.sources]

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

@@ -35,6 +35,7 @@ class _FakeNumber:
     country = "US"
     nickname = None
     calling_enabled = True
+    forward_to = None
 
 
 class FakeClient:
@@ -162,22 +163,23 @@ def test_send_message_into_a_group():
 
 def test_list_groups_renders_ids_names_and_an_unnamed_group():
     class _FakeGroup:
-        def __init__(self, id, name, created_at):
+        def __init__(self, id, channel, name, created_at):
             self.id = id
+            self.channel = channel
             self.name = name
             self.created_at = created_at
 
     client = FakeClient(
         list_groups=[
-            _FakeGroup("grp_1", "Planning bday party", "2026-09-01T00:00:00Z"),
-            _FakeGroup("grp_2", None, "2026-09-02T00:00:00Z"),
+            _FakeGroup("grp_1", "whatsapp", "Planning bday party", "2026-09-01T00:00:00Z"),
+            _FakeGroup("grp_2", "imessage", None, "2026-09-02T00:00:00Z"),
         ]
     )
     out = _run(list_groups_tool(client))
 
-    assert "grp_1: Planning bday party" in out
+    assert "grp_1 (whatsapp): Planning bday party" in out
     # A group no line could name is still listed — never hidden.
-    assert "grp_2: (unnamed)" in out
+    assert "grp_2 (imessage): (unnamed)" in out
 
 
 def test_stop_typing_invokes_client():
@@ -297,6 +299,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.21.0}/uv.lock

@@ -345,7 +345,7 @@ wheels = [
 
 [[package]]
 name = "dial-agentframework"
-version = "0.19.2"
+version = "0.21.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.33.0"
 source = { editable = "../sdk-python" }
 dependencies = [
     { name = "httpx" },