dial-agentframework 0.18.0__tar.gz → 0.19.0__tar.gz

{dial_agentframework-0.18.0 → dial_agentframework-0.19.0}/PKG-INFO

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

{dial_agentframework-0.18.0 → dial_agentframework-0.19.0}/dial_agentframework/__init__.py

@@ -6,6 +6,7 @@ from .tools import (
     list_messages_tool,
     list_groups_tool,
     list_contacts_tool,
+    lookup_number_tool,
     send_message_tool,
     reply_to_message_tool,
     start_typing_tool,
@@ -25,6 +26,7 @@ __all__ = [
     "list_messages_tool",
     "list_groups_tool",
     "list_contacts_tool",
+    "lookup_number_tool",
     "send_message_tool",
     "reply_to_message_tool",
     "start_typing_tool",

{dial_agentframework-0.18.0 → dial_agentframework-0.19.0}/dial_agentframework/tools.py

@@ -523,6 +523,43 @@ def list_contacts_tool(client: DialClient) -> FunctionTool:
     return list_contacts
 
 
+# ── Lookup ───────────────────────────────────────────────────────────────────
+
+
+def lookup_number_tool(client: DialClient) -> FunctionTool:
+    @tool(
+        name="lookup_number",
+        description=(
+            "Check what channels a phone number can receive on, before sending to it. "
+            "Works on ANY number in the world - it doesn't have to be one of your "
+            "numbers, and you don't have to have messaged it before. The answer "
+            "describes the number you asked about, not your own line, and it is "
+            "point-in-time rather than a property of the number: someone who changes "
+            "device or turns a service off stops being reachable. Treat a yes as a "
+            "strong signal for picking a channel rather than a promise that the send "
+            "will land. A lookup that fails raises rather than reporting no, so a no "
+            "always means the number genuinely isn't reachable there."
+        ),
+    )
+    async def lookup_number(
+        number: Annotated[
+            str,
+            "The phone number to look up, in E.164 - e.g. +14155550123. Any number in "
+            "the world, not just one of your own.",
+        ],
+    ) -> str:
+        result = await client.lookup_number(number)
+        # Rendered by name, so a channel added to the API after this SDK shipped is
+        # reported rather than silently dropped.
+        channels = ", ".join(
+            f"{channel}: {'yes' if supported else 'no'}"
+            for channel, supported in result.supports.items()
+        )
+        return f"{result.number} - {channels}"
+
+    return lookup_number
+
+
 # ── Calls ────────────────────────────────────────────────────────────────────
 
 
@@ -750,6 +787,7 @@ def dial_tools(client: DialClient) -> list[FunctionTool]:
         list_messages_tool(client),
         list_groups_tool(client),
         list_contacts_tool(client),
+        lookup_number_tool(client),
         send_message_tool(client),
         reply_to_message_tool(client),
         start_typing_tool(client),

{dial_agentframework-0.18.0 → dial_agentframework-0.19.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "dial-agentframework"
-version = "0.18.0"
+version = "0.19.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.28.0",
+    "dial-sdk>=0.30.0",
 ]
 
 [tool.uv.sources]

{dial_agentframework-0.18.0 → dial_agentframework-0.19.0}/tests/test_tools.py

@@ -11,6 +11,7 @@ from dial_agentframework import (
     stop_typing_tool,
     wait_for_message_tool,
     list_groups_tool,
+    lookup_number_tool,
 )
 
 
@@ -71,6 +72,7 @@ def test_dial_tools_bundles_all_fifteen():
             "list_messages",
             "list_groups",
             "list_contacts",
+        "lookup_number",
             "send_message",
             "reply_to_message",
             "start_typing",
@@ -340,3 +342,31 @@ def test_tools_share_one_client():
     client = FakeClient()
     tools = dial_tools(client)
     assert all(t is not None for t in tools)
+
+
+def test_lookup_number_renders_every_channel_it_is_given():
+    # Rendered by name, so a channel the API adds after this SDK ships is reported
+    # rather than silently dropped.
+    class _FakeLookup:
+        number = "+14155550123"
+        supports = {"imessage": True, "whatsapp": False}
+
+    client = FakeClient(lookup_number=_FakeLookup())
+    out = _run(lookup_number_tool(client), number="+14155550123")
+
+    assert "+14155550123" in out
+    assert "imessage: yes" in out
+    assert "whatsapp: no" in out
+
+
+def test_lookup_number_passes_the_number_through_untouched():
+    # Normalization belongs to the server, so the SDK must not pre-chew the input.
+    class _FakeLookup:
+        number = "+14155550123"
+        supports = {"imessage": True}
+
+    client = FakeClient(lookup_number=_FakeLookup())
+    _run(lookup_number_tool(client), number="+1 (415) 555-0123")
+
+    call = client.calls["lookup_number"]
+    assert "+1 (415) 555-0123" in (list(call["args"]) + list(call["kwargs"].values()))