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

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

@@ -1,10 +1,10 @@
 Metadata-Version: 2.5
 Name: dial-agentframework
-Version: 0.16.0
+Version: 0.18.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.22.0
+Requires-Dist: dial-sdk>=0.28.0
 Description-Content-Type: text/markdown
 
 # dial-agentframework
@@ -85,7 +85,8 @@ Each builder takes your shared `DialClient`:
 | `set_number_properties_tool` | `set_number_properties` | Update a number's nickname / inbound instruction |
 | `send_message_tool` | `send_message` | Send an SMS (optionally MMS) |
 | `reply_to_message_tool` | `reply_to_message` | Reply or react to a message |
-| `list_messages_tool` | `list_messages` | List recent messages |
+| `list_messages_tool` | `list_messages` | List recent messages (`contact` for one conversation, `search` by text) |
+| `list_contacts_tool` | `list_contacts` | List the numbers your lines have talked to |
 | `make_call_tool` | `make_call` | Place an AI voice call |
 | `list_calls_tool` | `list_calls` | List recent calls |
 | `get_call_tool` | `get_call` | Fetch one call by id |

{dial_agentframework-0.16.0 → dial_agentframework-0.18.0}/README.md

@@ -76,7 +76,8 @@ Each builder takes your shared `DialClient`:
 | `set_number_properties_tool` | `set_number_properties` | Update a number's nickname / inbound instruction |
 | `send_message_tool` | `send_message` | Send an SMS (optionally MMS) |
 | `reply_to_message_tool` | `reply_to_message` | Reply or react to a message |
-| `list_messages_tool` | `list_messages` | List recent messages |
+| `list_messages_tool` | `list_messages` | List recent messages (`contact` for one conversation, `search` by text) |
+| `list_contacts_tool` | `list_contacts` | List the numbers your lines have talked to |
 | `make_call_tool` | `make_call` | Place an AI voice call |
 | `list_calls_tool` | `list_calls` | List recent calls |
 | `get_call_tool` | `get_call` | Fetch one call by id |

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

@@ -5,6 +5,7 @@ from .tools import (
     set_number_properties_tool,
     list_messages_tool,
     list_groups_tool,
+    list_contacts_tool,
     send_message_tool,
     reply_to_message_tool,
     start_typing_tool,
@@ -23,6 +24,7 @@ __all__ = [
     "set_number_properties_tool",
     "list_messages_tool",
     "list_groups_tool",
+    "list_contacts_tool",
     "send_message_tool",
     "reply_to_message_tool",
     "start_typing_tool",

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

@@ -114,7 +114,8 @@ def set_number_properties_tool(client: DialClient) -> FunctionTool:
         name="set_number_properties",
         description=(
             "Update a Dial phone number's properties: its inbound instruction (the system "
-            "prompt its AI voice agent uses on inbound calls) and/or its nickname. "
+            "prompt its AI voice agent uses on inbound calls), its nickname, and/or whether "
+            "calling is switched on at all (calling_enabled). "
             "On iMessage numbers you can also set the display identity (first/last name "
             "and avatar photo) shown to recipients. Provide at least one."
         ),
@@ -164,6 +165,14 @@ def set_number_properties_tool(client: DialClient) -> FunctionTool:
             "as the number's iMessage display photo. iMessage numbers only (400 "
             "otherwise). The photo can be replaced but not removed.",
         ] = None,
+        calling_enabled: Annotated[
+            Optional[bool],
+            "Switch calling on or off for this number, in both directions. False stops "
+            "inbound calls from being connected (the caller is never answered) and makes "
+            "place_call from this number fail with calling_disabled (409); messaging on "
+            "the number is unaffected. Takes effect on the next call — a call already in "
+            "progress is not ended. Omit to leave it unchanged.",
+        ] = None,
     ) -> str:
         kwargs: dict = {}
         if inbound_instruction is not None:
@@ -187,15 +196,20 @@ def set_number_properties_tool(client: DialClient) -> FunctionTool:
             kwargs["last_name"] = last_name
         if avatar_url is not None:
             kwargs["avatar"] = avatar_url
+        # False is a real value here; only None means "leave unchanged".
+        if calling_enabled is not None:
+            kwargs["calling_enabled"] = calling_enabled
         if not kwargs:
             return (
                 "Provide at least one of inbound_instruction, inbound_voice_gender, "
-                "inbound_language, nickname, max_call_duration_seconds, first_name, "
-                "last_name, or avatar_url."
+                "inbound_language, nickname, max_call_duration_seconds, calling_enabled, "
+                "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 ""
-        return f"Updated {number.number} (id: {number.id}){nick}"
+        # 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}"
 
     return set_number_properties
 
@@ -207,8 +221,10 @@ def list_messages_tool(client: DialClient) -> FunctionTool:
     @tool(
         name="list_messages",
         description=(
-            "List recent inbound and outbound messages on the account. Pass group_id "
-            "to read one group conversation."
+            "List recent inbound and outbound messages on the account. Unfiltered this "
+            "is the newest 100 messages across every conversation, so pass contact to "
+            "read one person's conversation, group_id to read one group's, or search to "
+            "find a message by its text anywhere in the history."
         ),
     )
     async def list_messages(
@@ -223,9 +239,24 @@ def list_messages_tool(client: DialClient) -> FunctionTool:
             "Restrict to one group conversation (from list_groups). Combines with the "
             "other filters.",
         ] = None,
+        contact: Annotated[
+            Optional[str],
+            "One contact's conversation: messages exchanged with this number (E.164), "
+            "both directions, across every line on the account. Group messages are never "
+            "included - use group_id for those.",
+        ] = None,
+        search: Annotated[
+            Optional[str],
+            "Case-insensitive substring match on the message body. Searches the whole "
+            "history, then returns the 100 most recent matches.",
+        ] = None,
     ) -> str:
         messages = await client.list_messages(
-            number_id=number_id, direction=direction, group_id=group_id
+            number_id=number_id,
+            direction=direction,
+            group_id=group_id,
+            contact=contact,
+            search=search,
         )
         if not messages:
             return "No messages found."
@@ -439,13 +470,69 @@ def stop_typing_tool(client: DialClient) -> FunctionTool:
     return stop_typing
 
 
+# ── Contacts ─────────────────────────────────────────────────────────────────
+
+
+def list_contacts_tool(client: DialClient) -> FunctionTool:
+    @tool(
+        name="list_contacts",
+        description=(
+            "List every number the account's lines have exchanged a message or a call "
+            "with, newest activity first, with per-contact counts and a summary of the "
+            "most recent interaction. Derived from history - there is no address book to "
+            "add anyone to. Counts span every line, so one person reached on two of your "
+            "numbers is one contact. Groups are not contacts; use list_groups for those. "
+            "Pass a contact's number to list_messages as contact to read that "
+            "conversation."
+        ),
+    )
+    async def list_contacts(
+        limit: Annotated[Optional[int], "Max contacts to return (1-1000; default 100)"] = None,
+        starting_after: Annotated[
+            Optional[str],
+            "ISO-8601 cursor - the last_at of the last contact you received. Only "
+            "contacts with strictly older activity are returned.",
+        ] = None,
+    ) -> str:
+        page = await client.list_contacts(limit=limit, starting_after=starting_after)
+        if not page.contacts:
+            return "No contacts found."
+        lines = []
+        for c in page.contacts:
+            if c.last_kind == "call":
+                preview = f"{c.last_direction} call"
+                if c.last_call_duration:
+                    preview += f", {c.last_call_duration}s"
+            elif c.last_redacted:
+                preview = "(deleted by retention)"
+            elif not c.last_body:
+                preview = f"({c.last_media_count} media)" if c.last_media_count else ""
+            else:
+                preview = c.last_body[:50]
+            lines.append(
+                f"{c.number} | {c.message_count} msg, {c.call_count} call | "
+                f"{c.last_at} | {preview}"
+            )
+        if page.has_more:
+            # Named so the model can ask for the next page instead of assuming this is all.
+            lines.append(
+                f"(more contacts: call again with starting_after={page.contacts[-1].last_at})"
+            )
+        return "\n".join(lines)
+
+    return list_contacts
+
+
 # ── Calls ────────────────────────────────────────────────────────────────────
 
 
 def list_calls_tool(client: DialClient) -> FunctionTool:
     @tool(
         name="list_calls",
-        description="List recent inbound and outbound calls on the account.",
+        description=(
+            "List recent inbound and outbound calls on the account. Pass contact to read "
+            "one person's call history."
+        ),
     )
     async def list_calls(
         number_id: Annotated[
@@ -454,8 +541,15 @@ def list_calls_tool(client: DialClient) -> FunctionTool:
         direction: Annotated[
             Optional[str], "Filter by direction: 'inbound' or 'outbound'"
         ] = None,
+        contact: Annotated[
+            Optional[str],
+            "One contact's calls: exchanged with this number (E.164), both directions, "
+            "across every line on the account.",
+        ] = None,
     ) -> str:
-        calls = await client.list_calls(number_id=number_id, direction=direction)
+        calls = await client.list_calls(
+            number_id=number_id, direction=direction, contact=contact
+        )
         if not calls:
             return "No calls found."
         return "\n".join(
@@ -655,6 +749,7 @@ def dial_tools(client: DialClient) -> list[FunctionTool]:
         set_number_properties_tool(client),
         list_messages_tool(client),
         list_groups_tool(client),
+        list_contacts_tool(client),
         send_message_tool(client),
         reply_to_message_tool(client),
         start_typing_tool(client),

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

@@ -1,6 +1,6 @@
 [project]
 name = "dial-agentframework"
-version = "0.16.0"
+version = "0.18.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.22.0",
+    "dial-sdk>=0.28.0",
 ]
 
 [tool.uv.sources]

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

@@ -33,6 +33,7 @@ class _FakeNumber:
     number = "+14155550000"
     country = "US"
     nickname = None
+    calling_enabled = True
 
 
 class FakeClient:
@@ -60,7 +61,7 @@ def _run(tool, **args) -> str:
 # ── Tools ────────────────────────────────────────────────────────────────────
 
 
-def test_dial_tools_bundles_all_fourteen():
+def test_dial_tools_bundles_all_fifteen():
     names = sorted(t.name for t in dial_tools(FakeClient()))
     assert names == sorted(
         [
@@ -69,6 +70,7 @@ def test_dial_tools_bundles_all_fourteen():
             "set_number_properties",
             "list_messages",
             "list_groups",
+            "list_contacts",
             "send_message",
             "reply_to_message",
             "start_typing",

{dial_agentframework-0.16.0 → dial_agentframework-0.18.0}/uv.lock

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