release: 4.29.0

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "4.28.0"
+  ".": "4.29.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 34
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/retell%2Ftoddlzt-bd98f7f1d3719abfc66e25f422097c72c6504f85615412419bb88dafebb3d36e.yml
-openapi_spec_hash: 202e8e5ba60e0e03c6ef0ddf43af624b
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/retell%2Ftoddlzt-101be623bbd5eca19cb36dd5a5f75052d04ef89578dfd03bf675a5323e43ca8b.yml
+openapi_spec_hash: 5f06a39218b958f8973595f616d1586a
 config_hash: 9d9a24bf8bb4553cbb30ce59eb910b2f

CHANGELOG.md

@@ -1,5 +1,29 @@
 # Changelog
 
+## 4.29.0 (2025-05-14)
+
+Full Changelog: [v4.28.0...v4.29.0](https://github.com/RetellAI/retell-python-sdk/compare/v4.28.0...v4.29.0)
+
+### Features
+
+* **api:** api update ([3f6509c](https://github.com/RetellAI/retell-python-sdk/commit/3f6509cf38b6f1f3cb73b0d8bb918edb54c383ba))
+* **api:** api update ([dc02872](https://github.com/RetellAI/retell-python-sdk/commit/dc028721305eec0c8c6126ac795011b07c6d82cd))
+* **api:** api update ([4e2edb1](https://github.com/RetellAI/retell-python-sdk/commit/4e2edb1f2d4b9aa1116e31d546b005f1d03b1b48))
+* **api:** api update ([3cb87df](https://github.com/RetellAI/retell-python-sdk/commit/3cb87df96dfce683feaa0a4a3b8d7285da07678b))
+* **api:** api update ([fb974a7](https://github.com/RetellAI/retell-python-sdk/commit/fb974a7a9f4367f3146443b7d484997791f40639))
+* **api:** api update ([84bc6f9](https://github.com/RetellAI/retell-python-sdk/commit/84bc6f9064fe0272f3e71a0963ae7f17c92672ff))
+* **api:** api update ([f4a83f3](https://github.com/RetellAI/retell-python-sdk/commit/f4a83f3ec4a359547cc08917fc2277b8b4663fb6))
+
+
+### Bug Fixes
+
+* **package:** support direct resource imports ([94bf9a5](https://github.com/RetellAI/retell-python-sdk/commit/94bf9a5e4e91f44902d777683498b82bdba1a691))
+
+
+### Chores
+
+* **internal:** avoid errors for isinstance checks on proxies ([ae0efc9](https://github.com/RetellAI/retell-python-sdk/commit/ae0efc9c584268ba9bfd7b5a3681145a97322133))
+
 ## 4.28.0 (2025-04-28)
 
 Full Changelog: [v4.27.0...v4.28.0](https://github.com/RetellAI/retell-python-sdk/compare/v4.27.0...v4.28.0)

README.md

@@ -85,34 +85,19 @@ from retell import Retell
 
 client = Retell()
 
-call_responses = client.call.list(
-    filter_criteria={
-        "agent_id": ["agent_oBeDLoLOeuAbiuaMFXRtDOLriT12345"],
-        "call_status": ["ended"],
-        "call_successful": [True],
-        "call_type": ["phone_call"],
-        "direction": ["inbound"],
-        "disconnection_reason": ["user_hangup"],
-        "duration_ms": {
-            "lower_threshold": 0,
-            "upper_threshold": 0,
-        },
-        "e2e_latency_p50": {
-            "lower_threshold": 0,
-            "upper_threshold": 0,
-        },
-        "from_number": ["string"],
-        "in_voicemail": [True],
-        "start_timestamp": {
-            "lower_threshold": 1738475411000,
-            "upper_threshold": 1738475421000,
-        },
-        "to_number": ["string"],
-        "user_sentiment": ["Positive"],
-        "version": [0],
+agent_response = client.agent.create(
+    response_engine={
+        "llm_id": "llm_234sdertfsdsfsdf",
+        "type": "retell-llm",
+    },
+    voice_id="11labs-Adrian",
+    user_dtmf_options={
+        "digit_limit": 1,
+        "termination_key": "#",
+        "timeout_ms": 1000,
     },
 )
-print(call_responses.filter_criteria)
+print(agent_response.user_dtmf_options)
 ```
 
 ## Handling errors

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "retell-sdk"
-version = "4.28.0"
+version = "4.29.0"
 description = "The official Python library for the retell API"
 dynamic = ["readme"]
 license = "Apache-2.0"

src/retell/__init__.py

@@ -1,5 +1,7 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+import typing as _t
+
 from . import types
 from ._types import NOT_GIVEN, Omit, NoneType, NotGiven, Transport, ProxiesTypes
 from ._utils import file_from_path
@@ -68,6 +70,9 @@
     "DefaultAsyncHttpxClient",
 ]
 
+if not _t.TYPE_CHECKING:
+    from ._utils._resources_proxy import resources as resources
+
 _setup_logging()
 
 # Update the __module__ attribute for exported symbols so that

src/retell/_utils/_proxy.py

@@ -46,7 +46,10 @@ def __dir__(self) -> Iterable[str]:
     @property  # type: ignore
     @override
     def __class__(self) -> type:  # pyright: ignore
-        proxied = self.__get_proxied__()
+        try:
+            proxied = self.__get_proxied__()
+        except Exception:
+            return type(self)
         if issubclass(type(proxied), LazyProxy):
             return type(proxied)
         return proxied.__class__

src/retell/_utils/_resources_proxy.py

@@ -0,0 +1,24 @@
+from __future__ import annotations
+
+from typing import Any
+from typing_extensions import override
+
+from ._proxy import LazyProxy
+
+
+class ResourcesProxy(LazyProxy[Any]):
+    """A proxy for the `retell.resources` module.
+
+    This is used so that we can lazily import `retell.resources` only when
+    needed *and* so that users can just import `retell` and reference `retell.resources`
+    """
+
+    @override
+    def __load__(self) -> Any:
+        import importlib
+
+        mod = importlib.import_module("retell.resources")
+        return mod
+
+
+resources = ResourcesProxy().__as_proxied__()

src/retell/_version.py

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