cartesia-line 0.1.0a1__py3-none-any.whl → 0.1.1__py3-none-any.whl

{cartesia_line-0.1.0a1.dist-info → cartesia_line-0.1.1.dist-info}/METADATA

@@ -1,11 +1,11 @@
 Metadata-Version: 2.4
 Name: cartesia-line
-Version: 0.1.0a1
+Version: 0.1.1
 Summary: Cartesia Voice Agents SDK
 Author-email: "Cartesia AI, Inc." <support@cartesia.ai>
 License: Apache 2.0
 Project-URL: Repository, https://github.com/cartesia-ai/line
-Project-URL: Documentation, https://docs.cartesia.ai/line
+Project-URL: Documentation, https://docs.cartesia.ai/line/
 Project-URL: Homepage, https://cartesia.ai/agents
 Keywords: voice,agents,ai,cartesia
 Classifier: Development Status :: 4 - Beta
@@ -65,9 +65,9 @@ Build intelligent, low-latency voice agents with background reasoning.
 
 ## Quickstart (< 5 minutes)
 
-The Line SDK is designed to be used with the Cartesia [Line platform](https://cartesia.ai/line).
+The Line SDK is designed to be used with the Cartesia's voice agent platform [Line](https://cartesia.ai/agents).
 - Create a [Cartesia account](https://play.cartesia.ai).
-- Follow the [quickstart guide](https://docs.cartesia.ai/).
+- Follow the [quickstart guide](https://docs.cartesia.ai/line/start-building/talk-to-your-first-agent).
 
 And you'll be able to make your first voice call in a few minutes.
 
@@ -90,5 +90,9 @@ pip install cartesia-line
 ## Going Deeper
 
 - **More examples**: [examples/](examples/) - See all available examples and patterns
-- **Full API reference**: [docs.cartesia.ai/line](https://docs.cartesia.ai/)
+- **3rd party integrations**: [example_integrations/](example_integrations/) - See example integrations for external services
+
+  > [!NOTE]
+  > While Cartesia approves each example, they are implemented and maintained by our partners.
+- **Full API reference**: [docs.cartesia.ai/line](https://docs.cartesia.ai/line/)
 - **Get help**: [Discord community](https://discord.gg/cartesia)

{cartesia_line-0.1.0a1.dist-info → cartesia_line-0.1.1.dist-info}/RECORD

@@ -1,13 +1,13 @@
-cartesia_line-0.1.0a1.dist-info/licenses/LICENSE,sha256=ElpXuEGJlZ5XPeLe_tLbAmiEVE79EGxdy-aMw3JxE_Y,11347
+cartesia_line-0.1.1.dist-info/licenses/LICENSE,sha256=ElpXuEGJlZ5XPeLe_tLbAmiEVE79EGxdy-aMw3JxE_Y,11347
 line/__init__.py,sha256=glA0fvCL2xBmgC1cXZbiv6wcXS-yod7ctcL3EnoeEIk,790
-line/bridge.py,sha256=53N5UizGKjrb6iR27OQbTtjgQZ-rNLjEJT0HqQiLa-M,14216
+line/bridge.py,sha256=KjaZxEA1QuqtTASej5mYhe6C9OJdpu85b9jcEsBxMvA,14233
 line/bus.py,sha256=AGMwHCNftVeWDzl0o1Jd2iDm51q1FTBEOlJzGZLub1Q,14324
 line/call_request.py,sha256=JfYS4bAicuwjTHMXdK_PYbvSPj1dht44282yZACGUbU,847
-line/events.py,sha256=d_CtDTGvLyMwFjdO97FtpTwyBO8uSmCzB2CC7hYagiQ,5565
-line/harness.py,sha256=_4TJV3J2Sxdhz5JSuWXlthZLNmhfNlddHANzOLGjtec,8620
+line/events.py,sha256=PiM6l9YqnvhLa3BqVM8WPIj5nkOJdFylG1ZX3RAWVeI,5922
+line/harness.py,sha256=EG0nZ-KeVJ0_yKKbGUxVY_S3OI0aer82-amVtEatxJo,9060
 line/harness_types.py,sha256=Lwu1n2fAA5o-b_PjLWDSMu4G-GYEpb3X1CAUy3pvelk,2214
 line/routes.py,sha256=jR_bl96ujx5MYzdVb9YLkcAITCboosM9UM7f4Et9eBc,24446
-line/user_bridge.py,sha256=etnvSMALCDB7JOguW0imd41RSH3sHJ-oBHH2Hr7kSeQ,7620
+line/user_bridge.py,sha256=d8Hb8S7Q1D-yqAkz8I0nQGo_7dWv5Xy0iycSkFWirmw,7880
 line/voice_agent_app.py,sha256=xlhtc9ZER2v5hOOWHz9W8e9jALlMAz_OvEcJL5QCNsQ,5421
 line/voice_agent_system.py,sha256=8yywrjKdO43s7UkKqIs0jqte27vOF96NYnuGILsJz7k,8002
 line/nodes/__init__.py,sha256=Rp-9gxMZ4hCTjbm6zaiTTBz6lg9d32UwxJgWTJfhnZU,128
@@ -15,13 +15,13 @@ line/nodes/base.py,sha256=HKfv_j3H-E-cwhtK9La1DUNmYdtbGUNeo-c51TGIQKM,1897
 line/nodes/conversation_context.py,sha256=1ytf4q5GGy6tEjVD_KbKAkKLqosCkwi0kVWGymuLJhw,2138
 line/nodes/reasoning.py,sha256=kyXxk6xJHEA4zwkHzriRtOC6cjk13E-N736qDvR5o-A,8567
 line/tools/__init__.py,sha256=mYzcKIk1G_-EFQD6ugoCdcPjgywK_mC4dXu-ZyAtS7U,203
-line/tools/system_tools.py,sha256=Z0tDoaAtZ9GziBLSDklhE6NS91OoHrmGkgToP5nZD_o,3765
+line/tools/system_tools.py,sha256=E8buuDpjopqlqaW5vGG315x1GkIfspDt36BMhMhVC3M,6136
 line/tools/tool_types.py,sha256=JJ6mfH9wB-dtaQFHkm8vsJIYsAiW6bIpgAh_nmDn744,1066
 line/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 line/utils/aio.py,sha256=l1YgZ8tf1KtOyq6A-6RA_kE-FKGafDfHERFnDx0-PxM,1899
 line/utils/gemini_utils.py,sha256=6YNyU3-I6Kn95j0qMroelO1WpjIPjIwhiub2lX34-kY,5396
 line/utils/openai_utils.py,sha256=I9nIpHTFC98ChWzRmV-enMSIcicRVF9KYjifsWkoPCE,3596
-cartesia_line-0.1.0a1.dist-info/METADATA,sha256=_47ursMi_LDtkwhqeKmOjbQFy51r6JQMzL_iptiVf1M,4001
-cartesia_line-0.1.0a1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-cartesia_line-0.1.0a1.dist-info/top_level.txt,sha256=xztzr4hR6ekbxrTcEufazgor-5McHQuLNu82cxn1jNE,5
-cartesia_line-0.1.0a1.dist-info/RECORD,,
+cartesia_line-0.1.1.dist-info/METADATA,sha256=SlilXhNIOjlqsfAJOnaoIWsWgeo9FwE54rxLyM6AjP4,4299
+cartesia_line-0.1.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+cartesia_line-0.1.1.dist-info/top_level.txt,sha256=xztzr4hR6ekbxrTcEufazgor-5McHQuLNu82cxn1jNE,5
+cartesia_line-0.1.1.dist-info/RECORD,,

line/bridge.py

@@ -13,7 +13,11 @@ from typing import TYPE_CHECKING, Any, Callable, List, Optional, Type, TypeVar,
 from loguru import logger
 
 from line.bus import Bus, Message
-from line.events import EventInstance, EventsRegistry, EventTypeOrAlias
+from line.events import (
+    EventInstance,
+    EventsRegistry,
+    EventTypeOrAlias,
+)
 from line.routes import RouteBuilder, RouteHandler
 
 if TYPE_CHECKING:

line/events.py

@@ -38,6 +38,9 @@ __all__ = [
     "AgentSpeechSent",
     "UserUnknownInputReceived",
     "LogMetric",
+    "DTMFInputEvent",
+    "DTMFOutputEvent",
+    "DTMFStoppedEvent",
 ]
 
 
@@ -183,6 +186,22 @@ class LogMetric(BaseModel):
     value: Any
 
 
+class DTMFInputEvent(BaseModel):
+    """DTMF event for tracking DTMF input."""
+
+    button: str
+
+
+class DTMFOutputEvent(BaseModel):
+    """DTMF event for tracking DTMF input."""
+
+    button: str
+
+
+class DTMFStoppedEvent(BaseModel):
+    """DTMF stopped event for tracking DTMF input."""
+
+
 class _EventsRegistry:
     """A singleton registry of all events.
 

line/harness.py

@@ -16,6 +16,7 @@ from line.events import (
     AgentSpeechSent,
     AgentStartedSpeaking,
     AgentStoppedSpeaking,
+    DTMFInputEvent,
     UserStartedSpeaking,
     UserStoppedSpeaking,
     UserTranscriptionReceived,
@@ -24,6 +25,8 @@ from line.events import (
 from line.harness_types import (
     AgentSpeechInput,
     AgentStateInput,
+    DTMFInput,
+    DTMFOutput,
     EndCallOutput,
     ErrorOutput,
     InputMessage,
@@ -199,6 +202,15 @@ class ConversationHarness:
         logger.debug(f"📈 Logging metric: {name}={value}")
         await self._send(LogMetricOutput(name=name, value=value))
 
+    async def send_dtmf(self, button: str):
+        """
+        Send a DTMF event via WebSocket
+
+        Args:
+            button: The DTMF button to send
+        """
+        await self._send(DTMFOutput(button=button))
+
     async def cleanup(self):
         """
         Clean up resources and stop all tasks
@@ -249,6 +261,9 @@ class ConversationHarness:
         elif isinstance(message, AgentSpeechInput):
             logger.info(f'🗣️ Agent speech sent: "{message.content}"')
             return [AgentSpeechSent(content=message.content)]
+        elif isinstance(message, DTMFInput):
+            logger.info(f"🔔 DTMF received: {message.button}")
+            return [DTMFInputEvent(button=message.button)]
         else:
             # Fallback for unknown types.
             logger.warning(f"Unknown message type: {type(message).__name__} ({message.model_dump_json()})")

line/tools/system_tools.py

@@ -118,3 +118,75 @@ async def end_call(
 
     # End the call
     yield EndCall()
+
+
+class DTMFToolCall(ToolDefinition):
+    """Arguments for the dtmf_tool_call tool."""
+
+    @classmethod
+    def name(cls) -> str:
+        return "dtmf_tool_call"
+
+    @classmethod
+    def description(cls) -> str:
+        return (
+            "Send a DTMF tone to the user. Use this when you find the "
+            "appropriate selection and the voice system asks you to press a button"
+        )
+
+    @classmethod
+    def parameters_description(cls) -> str:
+        return "The DTMF button to send"
+
+    @classmethod
+    def to_gemini_tool(cls) -> "gemini_types.Tool":
+        """Convert to Gemini tool format"""
+        return gemini_types.Tool(
+            function_declarations=[
+                gemini_types.FunctionDeclaration(
+                    name=cls.name(),
+                    description=cls.description(),
+                    parameters={
+                        "type": "object",
+                        "properties": {
+                            "button": {
+                                "type": "string",
+                                "description": cls.parameters_description(),
+                                "enum": ["0", "1", "2", "3", "4", "5", "6", "7", "8", "9", "*", "#"],
+                            }
+                        },
+                        "required": ["button"],
+                    },
+                )
+            ]
+        )
+
+    @classmethod
+    def to_openai_tool(cls) -> Dict[str, object]:
+        """Convert to OpenAI tool format for Responses API.
+
+        Note: This returns the format expected by OpenAI's Responses API,
+        not the Chat Completions API format.
+        """
+        return {
+            "type": "function",
+            "name": cls.name(),
+            "description": cls.description(),
+            "parameters": {
+                "type": "object",
+                "properties": {
+                    "button": {
+                        "type": "string",
+                        "enum": ["0", "1", "2", "3", "4", "5", "6", "7", "8", "9", "*", "#"],
+                        "description": cls.parameters_description(),
+                    },
+                },
+                "required": ["button"],
+                "additionalProperties": False,
+                "strict": True,
+            },
+        }
+
+
+class DTMFToolCallTool(ToolDefinition):
+    """DTMF tool call system tool definition."""

line/user_bridge.py

@@ -44,6 +44,7 @@ from line.events import (
     AgentError,
     AgentResponse,
     Authorize,
+    DTMFOutputEvent,
     EndCall,
     EventType,
     LogMetric,
@@ -111,6 +112,11 @@ def create_user_bridge(harness: "ConversationHarness", authorized_node: str) ->
         event: LogMetric = message.event
         return await harness.log_metric(event.name, event.value)
 
+    async def send_dtmf(message: Message):
+        """Send DTMF event to harness."""
+        event: DTMFOutputEvent = message.event
+        return await harness.send_dtmf(event.button)
+
     bridge = (
         Bridge(harness)
         .with_input_routing(harness)  # Enable WebSocket → bus event routing
@@ -132,6 +138,8 @@ def create_user_bridge(harness: "ConversationHarness", authorized_node: str) ->
         .map(send_transfer_call)
         .on(LogMetric)
         .map(send_log_metric)
+        .on(DTMFOutputEvent)
+        .map(send_dtmf)
     )
 
     # Add authorization handler after creation.