release: 4.96.0 (#250)

* feat: AI-2180: Add message_template to SendMessageTool schema

* release: 4.96.0

---------

Co-authored-by: stainless-app[bot] <142633134+stainless-app[bot]@users.noreply.github.com>

Author: stainless-app[bot]

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "4.95.0"
+  ".": "4.96.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 1022
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/telnyx%2Ftelnyx-bd7b53aa31b84a32ceb374b371804a27876a0ef77cf48e61f7a0b68eddc5922b.yml
-openapi_spec_hash: 82263212fe68d2f3f80e6bd6a0c0bcac
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/telnyx%2Ftelnyx-89a9050aa64756582ce8923c6abfaa5eae030e794b53d10bab86b15fa30b02bf.yml
+openapi_spec_hash: da75df9cb0618f9a3d6eb8a2f77b0752
 config_hash: 6d9dae7db10d5a23624637b34428fcfd

CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 4.96.0 (2026-04-07)
+
+Full Changelog: [v4.95.0...v4.96.0](https://github.com/team-telnyx/telnyx-python/compare/v4.95.0...v4.96.0)
+
+### Features
+
+* AI-2180: Add message_template to SendMessageTool schema ([7e21d03](https://github.com/team-telnyx/telnyx-python/commit/7e21d03c66deab58fdad063a0f9b2b14805576d2))
+
 ## 4.95.0 (2026-04-07)
 
 Full Changelog: [v4.94.1...v4.95.0](https://github.com/team-telnyx/telnyx-python/compare/v4.94.1...v4.95.0)

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "telnyx"
-version = "4.95.0"
+version = "4.96.0"
 description = "The official Python library for the telnyx API"
 dynamic = ["readme"]
 license = "MIT"

src/telnyx/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "telnyx"
-__version__ = "4.95.0"  # x-release-please-version
+__version__ = "4.96.0"  # x-release-please-version

src/telnyx/types/ai/assistant_tool.py

@@ -1,6 +1,6 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-from typing import Dict, List, Union, Optional
+from typing import TYPE_CHECKING, Dict, List, Union, Optional
 from typing_extensions import Literal, Annotated, TypeAlias
 
 from pydantic import Field as FieldInfo
@@ -36,6 +36,7 @@
     "ReferReferSipHeader",
     "SendDtmf",
     "SendMessage",
+    "SendMessageSendMessage",
     "SkipTurn",
     "SkipTurnSkipTurn",
 ]
@@ -357,12 +358,35 @@ class SendDtmf(BaseModel):
     type: Literal["send_dtmf"]
 
 
+class SendMessageSendMessage(BaseModel):
+    message_template: Optional[str] = None
+    """
+    Optional message template with dynamic variable support using mustache syntax
+    (e.g., {{variable_name}}). When set, the assistant will use this template for
+    the SMS body instead of generating one. Dynamic variables like
+    {{telnyx_end_user_target}}, {{telnyx_agent_target}}, and custom webhook-provided
+    variables will be resolved at runtime.
+    """
+
+    if TYPE_CHECKING:
+        # Some versions of Pydantic <2.8.0 have a bug and don’t allow assigning a
+        # value to this field, so for compatibility we avoid doing it at runtime.
+        __pydantic_extra__: Dict[str, object] = FieldInfo(init=False)  # pyright: ignore[reportIncompatibleVariableOverride]
+
+        # Stub to indicate that arbitrary properties are accepted.
+        # To access properties that are not valid identifiers you can use `getattr`, e.g.
+        # `getattr(obj, '$type')`
+        def __getattr__(self, attr: str) -> object: ...
+    else:
+        __pydantic_extra__: Dict[str, object]
+
+
 class SendMessage(BaseModel):
     """
-    The send_message tool allows the assistant to send SMS or MMS messages to the end user. The 'to' and 'from' addresses are automatically determined from the conversation context, and the message text is generated by the assistant.
+    The send_message tool allows the assistant to send SMS or MMS messages to the end user. The 'to' and 'from' addresses are automatically determined from the conversation context, and the message text is generated by the assistant unless a message_template is provided for runtime variable substitution.
     """
 
-    send_message: Dict[str, object]
+    send_message: SendMessageSendMessage
 
     type: Literal["send_message"]
 

src/telnyx/types/ai/assistant_tool_param.py

@@ -34,6 +34,7 @@
     "ReferReferSipHeader",
     "SendDtmf",
     "SendMessage",
+    "SendMessageSendMessage",
     "SkipTurn",
     "SkipTurnSkipTurn",
 ]
@@ -367,12 +368,23 @@ class SendDtmf(TypedDict, total=False):
     type: Required[Literal["send_dtmf"]]
 
 
+class SendMessageSendMessage(TypedDict, total=False, extra_items=object):  # type: ignore[call-arg]
+    message_template: Optional[str]
+    """
+    Optional message template with dynamic variable support using mustache syntax
+    (e.g., {{variable_name}}). When set, the assistant will use this template for
+    the SMS body instead of generating one. Dynamic variables like
+    {{telnyx_end_user_target}}, {{telnyx_agent_target}}, and custom webhook-provided
+    variables will be resolved at runtime.
+    """
+
+
 class SendMessage(TypedDict, total=False):
     """
-    The send_message tool allows the assistant to send SMS or MMS messages to the end user. The 'to' and 'from' addresses are automatically determined from the conversation context, and the message text is generated by the assistant.
+    The send_message tool allows the assistant to send SMS or MMS messages to the end user. The 'to' and 'from' addresses are automatically determined from the conversation context, and the message text is generated by the assistant unless a message_template is provided for runtime variable substitution.
     """
 
-    send_message: Required[Dict[str, object]]
+    send_message: Required[SendMessageSendMessage]
 
     type: Required[Literal["send_message"]]