dial-agentframework 0.13.0__tar.gz → 0.14.0__tar.gz

{dial_agentframework-0.13.0 → dial_agentframework-0.14.0}/PKG-INFO

@@ -1,10 +1,10 @@
 Metadata-Version: 2.4
 Name: dial-agentframework
-Version: 0.13.0
+Version: 0.14.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.14.0
+Requires-Dist: dial-sdk>=0.16.0
 Description-Content-Type: text/markdown
 
 # dial-agentframework

{dial_agentframework-0.13.0 → dial_agentframework-0.14.0}/dial_agentframework/__init__.py

@@ -6,6 +6,8 @@ from .tools import (
     list_messages_tool,
     send_message_tool,
     reply_to_message_tool,
+    start_typing_tool,
+    stop_typing_tool,
     list_calls_tool,
     make_call_tool,
     get_call_tool,
@@ -21,6 +23,8 @@ __all__ = [
     "list_messages_tool",
     "send_message_tool",
     "reply_to_message_tool",
+    "start_typing_tool",
+    "stop_typing_tool",
     "list_calls_tool",
     "make_call_tool",
     "get_call_tool",

{dial_agentframework-0.13.0 → dial_agentframework-0.14.0}/dial_agentframework/tools.py

@@ -192,7 +192,16 @@ def send_message_tool(client: DialClient) -> FunctionTool:
     )
     async def send_message(
         to: Annotated[str, "Destination phone number in E.164 format, e.g. +1234567890"],
-        from_number_id: Annotated[str, "ID of the Dial phone number to send from"],
+        from_number: Annotated[
+            Optional[str],
+            "Number to send from: a phone number ID, one of your numbers in E.164, or "
+            "a nickname. Exclusive with from_number_id — provide exactly one.",
+        ] = None,
+        from_number_id: Annotated[
+            Optional[str],
+            "ID of the Dial phone number to send from. Exclusive with from_number — "
+            "provide exactly one.",
+        ] = None,
         body: Annotated[
             str, "Message body text; optional when media_urls is given (media-only send)"
         ] = "",
@@ -211,6 +220,7 @@ def send_message_tool(client: DialClient) -> FunctionTool:
         msg = await client.send_message(
             SendMessageParams(
                 to=to,
+                from_number=from_number,
                 from_number_id=from_number_id,
                 body=body,
                 channel=channel,
@@ -263,6 +273,59 @@ def reply_to_message_tool(client: DialClient) -> FunctionTool:
     return reply_to_message
 
 
+def start_typing_tool(client: DialClient) -> FunctionTool:
+    @tool(
+        name="start_typing",
+        description=(
+            "Show a typing indicator to the recipient, as if composing a message from "
+            "your number. iMessage numbers display it; standard (SMS) numbers have no "
+            "typing concept and silently ignore it, so it is always safe to call before "
+            "send_message. Fire-and-forget and free. Delivering a message or reaction "
+            "clears the indicator natively on the recipient's device — call start_typing "
+            "again after a send to keep composing, and stop_typing when you stop without sending."
+        ),
+    )
+    async def start_typing(
+        to_number: Annotated[
+            str, "Recipient phone number in E.164 format, e.g. +14155550123"
+        ],
+        from_number: Annotated[
+            str,
+            "Number the indicator appears from: a phone number ID, one of your numbers "
+            "in E.164, or a nickname",
+        ],
+    ) -> str:
+        await client.start_typing(to_number=to_number, from_number=from_number)
+        return "Typing indicator shown (iMessage numbers only — SMS numbers ignore it)."
+
+    return start_typing
+
+
+def stop_typing_tool(client: DialClient) -> FunctionTool:
+    @tool(
+        name="stop_typing",
+        description=(
+            "Clear a typing indicator previously shown with start_typing. Delivering a "
+            "message or reaction already clears it natively on the recipient's device — "
+            "call this when you stop composing without sending."
+        ),
+    )
+    async def stop_typing(
+        to_number: Annotated[
+            str, "Recipient phone number in E.164 format, e.g. +14155550123"
+        ],
+        from_number: Annotated[
+            str,
+            "Number the indicator appears from: a phone number ID, one of your numbers "
+            "in E.164, or a nickname",
+        ],
+    ) -> str:
+        await client.stop_typing(to_number=to_number, from_number=from_number)
+        return "Typing indicator cleared."
+
+    return stop_typing
+
+
 # ── Calls ────────────────────────────────────────────────────────────────────
 
 
@@ -298,10 +361,19 @@ def make_call_tool(client: DialClient) -> FunctionTool:
     )
     async def make_call(
         to: Annotated[str, "Destination phone number in E.164 format, e.g. +1234567890"],
-        from_number_id: Annotated[str, "ID of the Dial phone number to call from"],
         outbound_instruction: Annotated[
             str, "System prompt for the AI voice agent during this call"
         ],
+        from_number: Annotated[
+            Optional[str],
+            "Number to call from: a phone number ID, one of your numbers in E.164, or "
+            "a nickname. Exclusive with from_number_id — provide exactly one.",
+        ] = None,
+        from_number_id: Annotated[
+            Optional[str],
+            "ID of the Dial phone number to call from. Exclusive with from_number — "
+            "provide exactly one.",
+        ] = None,
         language: Annotated[
             Optional[str],
             "BCP-47 language tag, e.g. 'en-US', 'he-IL'. Omit to auto-detect from the "
@@ -332,6 +404,7 @@ def make_call_tool(client: DialClient) -> FunctionTool:
         call = await client.make_call(
             MakeCallParams(
                 to=to,
+                from_number=from_number,
                 from_number_id=from_number_id,
                 outbound_instruction=outbound_instruction,
                 language=language,
@@ -470,6 +543,8 @@ def dial_tools(client: DialClient) -> list[FunctionTool]:
         list_messages_tool(client),
         send_message_tool(client),
         reply_to_message_tool(client),
+        start_typing_tool(client),
+        stop_typing_tool(client),
         list_calls_tool(client),
         make_call_tool(client),
         get_call_tool(client),

{dial_agentframework-0.13.0 → dial_agentframework-0.14.0}/pyproject.toml

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

{dial_agentframework-0.13.0 → dial_agentframework-0.14.0}/tests/test_tools.py

@@ -6,6 +6,8 @@ from dial_agentframework import (
     send_message_tool,
     reply_to_message_tool,
     make_call_tool,
+    start_typing_tool,
+    stop_typing_tool,
     wait_for_message_tool,
 )
 
@@ -55,7 +57,7 @@ def _run(tool, **args) -> str:
 # ── Tools ────────────────────────────────────────────────────────────────────
 
 
-def test_dial_tools_bundles_all_eleven():
+def test_dial_tools_bundles_all_thirteen():
     names = sorted(t.name for t in dial_tools(FakeClient()))
     assert names == sorted(
         [
@@ -65,6 +67,8 @@ def test_dial_tools_bundles_all_eleven():
             "list_messages",
             "send_message",
             "reply_to_message",
+            "start_typing",
+            "stop_typing",
             "list_calls",
             "make_call",
             "get_call",
@@ -104,6 +108,44 @@ def test_send_message_media_only_with_force_audio_file():
     assert params.media == ["https://cdn.example.com/note.m4a"]
 
 
+def test_send_message_passes_from_number():
+    client = FakeClient(send_message=_FakeMessage())
+    tool = send_message_tool(client)
+    out = _run(tool, to="+14155550123", from_number="Support line", body="hi")
+
+    assert "msg_1" in out
+    params = client.calls["send_message"]["args"][0]
+    assert params.from_number == "Support line"
+    assert params.from_number_id is None
+
+
+def test_start_typing_invokes_client():
+    client = FakeClient(start_typing=None)
+    tool = start_typing_tool(client)
+    assert tool.name == "start_typing"
+    out = _run(tool, to_number="+14155550123", from_number="pn_9")
+
+    assert "Typing indicator shown" in out
+    call = client.calls["start_typing"]
+    assert call["args"] == ()
+    assert call["kwargs"] == {"to_number": "+14155550123", "from_number": "pn_9"}
+
+
+def test_stop_typing_invokes_client():
+    client = FakeClient(stop_typing=None)
+    tool = stop_typing_tool(client)
+    assert tool.name == "stop_typing"
+    out = _run(tool, to_number="+14155550123", from_number="+14155559999")
+
+    assert "Typing indicator cleared" in out
+    call = client.calls["stop_typing"]
+    assert call["args"] == ()
+    assert call["kwargs"] == {
+        "to_number": "+14155550123",
+        "from_number": "+14155559999",
+    }
+
+
 def test_reply_to_message_sends_body_or_reaction():
     client = FakeClient(reply_to_message=_FakeMessage())
     tool = reply_to_message_tool(client)
@@ -176,6 +218,22 @@ def test_make_call_passes_idempotency_key():
     assert params.outbound_instruction == "Confirm the booking."
 
 
+def test_make_call_passes_from_number():
+    client = FakeClient(make_call=_FakeCall())
+    tool = make_call_tool(client)
+    out = _run(
+        tool,
+        to="+14155550123",
+        from_number="+14155559999",
+        outbound_instruction="Confirm the booking.",
+    )
+
+    assert "call_x" in out
+    params = client.calls["make_call"]["args"][0]
+    assert params.from_number == "+14155559999"
+    assert params.from_number_id is None
+
+
 def test_wait_for_message_unknown_id():
     # list_numbers returns no match → reports the bad id without opening a stream.
     tool = wait_for_message_tool(FakeClient(list_numbers=[]))

{dial_agentframework-0.13.0 → dial_agentframework-0.14.0}/uv.lock

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