cartesia-line 0.2.0.dev0__tar.gz → 0.2.0.dev2__tar.gz

{cartesia_line-0.2.0.dev0 → cartesia_line-0.2.0.dev2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cartesia-line
-Version: 0.2.0.dev0
+Version: 0.2.0.dev2
 Summary: Cartesia Voice Agents SDK
 Author-email: "Cartesia AI, Inc." <support@cartesia.ai>
 License: Apache 2.0
@@ -29,8 +29,8 @@ Requires-Dist: fastapi>=0.115.0
 Requires-Dist: aiohttp>=3.8.0
 Requires-Dist: pydantic<3,>=2.0.0
 Requires-Dist: uvicorn<1,>=0.35.0
-Requires-Dist: litellm>=1.81.1
-Requires-Dist: duckduckgo-search>=8.1.1
+Requires-Dist: websockets>=13.0.0
+Requires-Dist: litellm>=1.81.6
 Requires-Dist: ddgs>=9.8.0
 Requires-Dist: phonenumbers>=9.0.22
 Requires-Dist: build>=1.4.0
@@ -43,13 +43,6 @@ Requires-Dist: pytest-repeat==0.9.4; extra == "dev"
 Requires-Dist: pre-commit; extra == "dev"
 Requires-Dist: ruff==0.12.8; extra == "dev"
 Requires-Dist: google-genai<2,>=1.26.0; extra == "dev"
-Provides-Extra: gemini
-Requires-Dist: google-genai<2,>=1.26.0; python_version >= "3.9" and extra == "gemini"
-Requires-Dist: aiohttp>=3.12.0; extra == "gemini"
-Provides-Extra: openai
-Requires-Dist: openai>=1.70.0; extra == "openai"
-Provides-Extra: llm
-Requires-Dist: litellm>=1.56.0; extra == "llm"
 Dynamic: license-file
 
 # Cartesia Line SDK

{cartesia_line-0.2.0.dev0 → cartesia_line-0.2.0.dev2}/cartesia_line.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cartesia-line
-Version: 0.2.0.dev0
+Version: 0.2.0.dev2
 Summary: Cartesia Voice Agents SDK
 Author-email: "Cartesia AI, Inc." <support@cartesia.ai>
 License: Apache 2.0
@@ -29,8 +29,8 @@ Requires-Dist: fastapi>=0.115.0
 Requires-Dist: aiohttp>=3.8.0
 Requires-Dist: pydantic<3,>=2.0.0
 Requires-Dist: uvicorn<1,>=0.35.0
-Requires-Dist: litellm>=1.81.1
-Requires-Dist: duckduckgo-search>=8.1.1
+Requires-Dist: websockets>=13.0.0
+Requires-Dist: litellm>=1.81.6
 Requires-Dist: ddgs>=9.8.0
 Requires-Dist: phonenumbers>=9.0.22
 Requires-Dist: build>=1.4.0
@@ -43,13 +43,6 @@ Requires-Dist: pytest-repeat==0.9.4; extra == "dev"
 Requires-Dist: pre-commit; extra == "dev"
 Requires-Dist: ruff==0.12.8; extra == "dev"
 Requires-Dist: google-genai<2,>=1.26.0; extra == "dev"
-Provides-Extra: gemini
-Requires-Dist: google-genai<2,>=1.26.0; python_version >= "3.9" and extra == "gemini"
-Requires-Dist: aiohttp>=3.12.0; extra == "gemini"
-Provides-Extra: openai
-Requires-Dist: openai>=1.70.0; extra == "openai"
-Provides-Extra: llm
-Requires-Dist: litellm>=1.56.0; extra == "llm"
 Dynamic: license-file
 
 # Cartesia Line SDK

{cartesia_line-0.2.0.dev0 → cartesia_line-0.2.0.dev2}/cartesia_line.egg-info/SOURCES.txt

@@ -21,15 +21,6 @@ line/llm_agent/tools/__init__.py
 line/llm_agent/tools/decorators.py
 line/llm_agent/tools/system.py
 line/llm_agent/tools/utils.py
-line/v02/example_integrations/browserbase/main.py
-line/v02/example_integrations/browserbase/stagehand_form_filler.py
-line/v02/example_integrations/exa/main.py
-line/v02/examples/basic_chat/main.py
-line/v02/examples/echo/main.py
-line/v02/examples/echo/tools.py
-line/v02/examples/form_filler/form_filler.py
-line/v02/examples/form_filler/main.py
-line/v02/examples/transfer_phone_call/main.py
 tests/test_llm_agent_config.py
 tests/test_llm_agent_llm_agent.py
 tests/test_llm_agent_tools_decorators.py

{cartesia_line-0.2.0.dev0 → cartesia_line-0.2.0.dev2}/cartesia_line.egg-info/requires.txt

@@ -4,8 +4,8 @@ fastapi>=0.115.0
 aiohttp>=3.8.0
 pydantic<3,>=2.0.0
 uvicorn<1,>=0.35.0
-litellm>=1.81.1
-duckduckgo-search>=8.1.1
+websockets>=13.0.0
+litellm>=1.81.6
 ddgs>=9.8.0
 phonenumbers>=9.0.22
 build>=1.4.0
@@ -19,15 +19,3 @@ pytest-repeat==0.9.4
 pre-commit
 ruff==0.12.8
 google-genai<2,>=1.26.0
-
-[gemini]
-aiohttp>=3.12.0
-
-[gemini:python_version >= "3.9"]
-google-genai<2,>=1.26.0
-
-[llm]
-litellm>=1.56.0
-
-[openai]
-openai>=1.70.0

{cartesia_line-0.2.0.dev0 → cartesia_line-0.2.0.dev2}/line/__init__.py

@@ -24,25 +24,12 @@ from line.events import (
     AgentTurnEnded,
     AgentTurnStarted,
     CallEnded,
-    # Input events (with history)
+    # Input events
     CallStarted,
     InputEvent,
     LogMessage,
     LogMetric,
     OutputEvent,
-    SpecificAgentDtmfSent,
-    SpecificAgentHandedOff,
-    SpecificAgentTextSent,
-    SpecificAgentTurnEnded,
-    SpecificAgentTurnStarted,
-    SpecificCallEnded,
-    # Specific input events (without history)
-    SpecificCallStarted,
-    SpecificInputEvent,
-    SpecificUserDtmfSent,
-    SpecificUserTextSent,
-    SpecificUserTurnEnded,
-    SpecificUserTurnStarted,
     UserDtmfSent,
     UserTextSent,
     UserTurnEnded,
@@ -101,7 +88,7 @@ __all__ = [
     "LogMetric",
     "LogMessage",
     "OutputEvent",
-    # Input events (with history)
+    # Input events
     "CallStarted",
     "CallEnded",
     "UserTurnStarted",
@@ -114,19 +101,6 @@ __all__ = [
     "AgentTurnEnded",
     "AgentHandedOff",
     "InputEvent",
-    # Specific input events
-    "SpecificCallStarted",
-    "SpecificCallEnded",
-    "SpecificUserTurnStarted",
-    "SpecificUserDtmfSent",
-    "SpecificUserTextSent",
-    "SpecificUserTurnEnded",
-    "SpecificAgentTurnStarted",
-    "SpecificAgentTextSent",
-    "SpecificAgentDtmfSent",
-    "SpecificAgentTurnEnded",
-    "SpecificAgentHandedOff",
-    "SpecificInputEvent",
     # Harness types
     "InputMessage",
     "OutputMessage",

{cartesia_line-0.2.0.dev0 → cartesia_line-0.2.0.dev2}/line/events.py

@@ -81,135 +81,87 @@ OutputEvent = Union[
 # -------------------------
 # Input Events (harness -> agent)
 # -------------------------
-# Specific* events do NOT include history and are used within the history list.
 # Each event has a stable event_id (UUID) for tracking which events trigger responses.
+# history=None indicates the event is used within a history list (no nested history).
 
 
-class SpecificCallStarted(BaseModel):
+class CallStarted(BaseModel):
     type: Literal["call_started"] = "call_started"
     event_id: str = Field(default_factory=_generate_event_id)
+    history: Optional[List["InputEvent"]] = None
 
 
-class SpecificCallEnded(BaseModel):
+class CallEnded(BaseModel):
     type: Literal["call_ended"] = "call_ended"
     event_id: str = Field(default_factory=_generate_event_id)
+    history: Optional[List["InputEvent"]] = None
 
 
-class SpecificAgentHandedOff(BaseModel):
+class AgentHandedOff(BaseModel):
     """Event emitted when control is transferred to the tool target."""
 
     type: Literal["agent_handed_off"] = "agent_handed_off"
     event_id: str = Field(default_factory=_generate_event_id)
+    history: Optional[List["InputEvent"]] = None
 
 
-class SpecificUserTurnStarted(BaseModel):
+class UserTurnStarted(BaseModel):
     type: Literal["user_turn_started"] = "user_turn_started"
     event_id: str = Field(default_factory=_generate_event_id)
+    history: Optional[List["InputEvent"]] = None
 
 
-class SpecificUserDtmfSent(BaseModel):
+class UserDtmfSent(BaseModel):
     type: Literal["user_dtmf_sent"] = "user_dtmf_sent"
     button: str
     event_id: str = Field(default_factory=_generate_event_id)
+    history: Optional[List["InputEvent"]] = None
 
 
-class SpecificUserTextSent(BaseModel):
+class UserTextSent(BaseModel):
     type: Literal["user_text_sent"] = "user_text_sent"
     content: str
     event_id: str = Field(default_factory=_generate_event_id)
+    history: Optional[List["InputEvent"]] = None
 
 
-class SpecificUserTurnEnded(BaseModel):
+class UserTurnEnded(BaseModel):
     type: Literal["user_turn_ended"] = "user_turn_ended"
-    content: List[Union[SpecificUserDtmfSent, SpecificUserTextSent]] = Field(default_factory=list)
+    content: List[Union[UserDtmfSent, UserTextSent]] = Field(default_factory=list)
     event_id: str = Field(default_factory=_generate_event_id)
+    history: Optional[List["InputEvent"]] = None
 
 
-class SpecificAgentTurnStarted(BaseModel):
+class AgentTurnStarted(BaseModel):
     type: Literal["agent_turn_started"] = "agent_turn_started"
     event_id: str = Field(default_factory=_generate_event_id)
+    history: Optional[List["InputEvent"]] = None
 
 
-class SpecificAgentTextSent(BaseModel):
+class AgentTextSent(BaseModel):
     type: Literal["agent_text_sent"] = "agent_text_sent"
     content: str
     event_id: str = Field(default_factory=_generate_event_id)
+    history: Optional[List["InputEvent"]] = None
 
 
-class SpecificAgentDtmfSent(BaseModel):
+class AgentDtmfSent(BaseModel):
     type: Literal["agent_dtmf_sent"] = "agent_dtmf_sent"
     button: str
     event_id: str = Field(default_factory=_generate_event_id)
+    history: Optional[List["InputEvent"]] = None
 
 
-class SpecificAgentTurnEnded(BaseModel):
+class AgentTurnEnded(BaseModel):
     type: Literal["agent_turn_ended"] = "agent_turn_ended"
     content: List[
         Union[
-            SpecificAgentTextSent,
-            SpecificAgentDtmfSent,
+            AgentTextSent,
+            AgentDtmfSent,
         ]
     ] = Field(default_factory=list)
     event_id: str = Field(default_factory=_generate_event_id)
-
-
-SpecificInputEvent = Union[
-    SpecificCallStarted,
-    SpecificAgentHandedOff,
-    SpecificUserTurnStarted,
-    SpecificUserDtmfSent,
-    SpecificUserTextSent,
-    SpecificUserTurnEnded,
-    SpecificAgentTurnStarted,
-    SpecificAgentTextSent,
-    SpecificAgentDtmfSent,
-    SpecificAgentTurnEnded,
-    SpecificCallEnded,
-]
-
-
-class CallStarted(SpecificCallStarted):
-    history: List[SpecificInputEvent] = Field(default_factory=list)
-
-
-class CallEnded(SpecificCallEnded):
-    history: List[SpecificInputEvent] = Field(default_factory=list)
-
-
-class UserTurnStarted(SpecificUserTurnStarted):
-    history: List[SpecificInputEvent] = Field(default_factory=list)
-
-
-class UserDtmfSent(SpecificUserDtmfSent):
-    history: List[SpecificInputEvent] = Field(default_factory=list)
-
-
-class UserTextSent(SpecificUserTextSent):
-    history: List[SpecificInputEvent] = Field(default_factory=list)
-
-
-class UserTurnEnded(SpecificUserTurnEnded):
-    history: List[SpecificInputEvent] = Field(default_factory=list)
-
-
-class AgentTurnStarted(SpecificAgentTurnStarted):
-    history: List[SpecificInputEvent] = Field(default_factory=list)
-
-
-class AgentTextSent(SpecificAgentTextSent):
-    history: List[SpecificInputEvent] = Field(default_factory=list)
-
-
-class AgentDtmfSent(SpecificAgentDtmfSent):
-    history: List[SpecificInputEvent] = Field(default_factory=list)
-
-
-class AgentTurnEnded(SpecificAgentTurnEnded):
-    history: List[SpecificInputEvent] = Field(default_factory=list)
-
-
-class AgentHandedOff(SpecificAgentHandedOff):
-    history: List[SpecificInputEvent] = Field(default_factory=list)
+    history: Optional[List["InputEvent"]] = None
 
 
 InputEvent = Union[
@@ -239,19 +191,7 @@ __all__ = [
     "LogMetric",
     "LogMessage",
     "OutputEvent",
-    # Input specific
-    "SpecificCallStarted",
-    "SpecificCallEnded",
-    "SpecificUserTurnStarted",
-    "SpecificUserDtmfSent",
-    "SpecificUserTextSent",
-    "SpecificUserTurnEnded",
-    "SpecificAgentTurnStarted",
-    "SpecificAgentTextSent",
-    "SpecificAgentDtmfSent",
-    "SpecificAgentTurnEnded",
-    "SpecificInputEvent",
-    # Input with history
+    # Input
     "CallStarted",
     "CallEnded",
     "UserTurnStarted",
@@ -262,6 +202,5 @@ __all__ = [
     "AgentTextSent",
     "AgentDtmfSent",
     "AgentTurnEnded",
-    "AgentHandedOff",
     "InputEvent",
 ]

{cartesia_line-0.2.0.dev0 → cartesia_line-0.2.0.dev2}/line/llm_agent/llm_agent.py

@@ -23,22 +23,19 @@ from loguru import logger
 
 from line.agent import AgentCallable, TurnEnv
 from line.events import (
+    AgentDtmfSent,
     AgentEndCall,
     AgentHandedOff,
     AgentSendDtmf,
     AgentSendText,
+    AgentTextSent,
     AgentToolCalled,
     AgentToolReturned,
     CallEnded,
     CallStarted,
     InputEvent,
     OutputEvent,
-    SpecificAgentDtmfSent,
-    SpecificAgentHandedOff,
-    SpecificAgentTextSent,
-    SpecificCallEnded,
-    SpecificInputEvent,
-    SpecificUserTextSent,
+    UserTextSent,
 )
 from line.llm_agent.config import LlmConfig
 from line.llm_agent.provider import LLMProvider, Message, ToolCall
@@ -406,9 +403,10 @@ class LlmAgent:
                         yield tool_returned_output
 
                         # AgentHandedOff input event is passed to the handoff target to execute the tool
-                        specific_event = SpecificAgentHandedOff()
+                        handed_off_event = AgentHandedOff()
                         event = AgentHandedOff(
-                            history=event.history + [specific_event], **specific_event.model_dump()
+                            history=event.history + [handed_off_event],
+                            **{k: v for k, v in handed_off_event.model_dump().items() if k != "history"},
                         )
                         self._append_to_local_history(event)
                         try:
@@ -442,7 +440,7 @@ class LlmAgent:
 
     def _build_messages(
         self,
-        input_history: List[SpecificInputEvent],
+        input_history: List[InputEvent],
         local_history: List[tuple[str, OutputEvent]],
         current_event_id: str,
     ) -> List[Message]:
@@ -455,17 +453,17 @@ class LlmAgent:
         4. Unobservable events (tool calls) are interpolated relative to observables
 
         The full_history contains:
-        - SpecificInputEvent for events from input_history
+        - InputEvent (with history=None) for events from input_history
         - OutputEvent for unobservable/current events from local_history
         """
         full_history = _build_full_history(input_history, local_history, current_event_id)
 
         messages = []
         for event in full_history:
-            # Handle SpecificInputEvent types (from input_history)
-            if isinstance(event, SpecificUserTextSent):
+            # Handle InputEvent types (from input_history)
+            if isinstance(event, UserTextSent):
                 messages.append(Message(role="user", content=event.content))
-            elif isinstance(event, SpecificAgentTextSent):
+            elif isinstance(event, AgentTextSent):
                 messages.append(Message(role="assistant", content=event.content))
             # Handle OutputEvent types (unobservable events from local_history)
             elif isinstance(event, AgentSendText):
@@ -603,10 +601,10 @@ class LlmAgent:
 
 
 def _build_full_history(
-    input_history: List[SpecificInputEvent],
+    input_history: List[InputEvent],
     local_history: List[tuple[str, OutputEvent]],
     current_event_id: str,
-) -> List[Union[SpecificInputEvent, OutputEvent]]:
+) -> List[Union[InputEvent, OutputEvent]]:
     """
     Build full history by merging input_history (canonical) with local_history.
 
@@ -645,7 +643,7 @@ def _build_full_history(
     trigger_event_ids = set(local_by_event_id.keys())
 
     # Process input in slices
-    result: List[Union[SpecificInputEvent, OutputEvent]] = []
+    result: List[Union[InputEvent, OutputEvent]] = []
     i = 0
 
     while i < len(input_history):
@@ -693,9 +691,9 @@ def _concat_contiguous_agent_send_text(local_history: List[OutputEvent]) -> List
 
 
 def _build_history_rec(
-    input_history: List[SpecificInputEvent],
+    input_history: List[InputEvent],
     local_history: List[OutputEvent],
-) -> List[Union[SpecificInputEvent, OutputEvent]]:
+) -> List[Union[InputEvent, OutputEvent]]:
     """
     Recursive implementation of history merging.
 
@@ -793,20 +791,20 @@ def _is_local_observable(event: OutputEvent) -> bool:
 
 
 OBSERVABLE_INPUT_EVENT_TYPES = (
-    SpecificAgentDtmfSent,
-    SpecificAgentTextSent,
-    SpecificCallEnded,
+    AgentDtmfSent,
+    AgentTextSent,
+    CallEnded,
 )
 
 
-def _is_input_observable(event: SpecificInputEvent) -> bool:
-    """Check if a SpecificInputEvent is observable (can be matched to local history)."""
+def _is_input_observable(event: InputEvent) -> bool:
+    """Check if an InputEvent is observable (can be matched to local history)."""
     return isinstance(event, OBSERVABLE_INPUT_EVENT_TYPES)
 
 
 def _try_match_events(
-    local: OutputEvent, input_evt: SpecificInputEvent
-) -> Optional[tuple[SpecificInputEvent, Optional[OutputEvent]]]:
+    local: OutputEvent, input_evt: InputEvent
+) -> Optional[tuple[InputEvent, Optional[OutputEvent]]]:
     """Try to match a local observable event to an input observable event.
 
     Returns:
@@ -817,16 +815,16 @@ def _try_match_events(
     For text events, supports prefix matching (input is prefix of local).
     For DTMF and EndCall events, only exact matching is supported.
     """
-    if isinstance(local, AgentSendText) and isinstance(input_evt, SpecificAgentTextSent):
+    if isinstance(local, AgentSendText) and isinstance(input_evt, AgentTextSent):
         if local.text == input_evt.content:
             return (input_evt, None)
         if local.text.startswith(input_evt.content):
             suffix = local.text[len(input_evt.content) :]
             return (input_evt, AgentSendText(text=suffix))
-    elif isinstance(local, AgentSendDtmf) and isinstance(input_evt, SpecificAgentDtmfSent):
+    elif isinstance(local, AgentSendDtmf) and isinstance(input_evt, AgentDtmfSent):
         if local.button == input_evt.button:
             return (input_evt, None)
-    elif isinstance(local, AgentEndCall) and isinstance(input_evt, SpecificCallEnded):
+    elif isinstance(local, AgentEndCall) and isinstance(input_evt, CallEnded):
         return (input_evt, None)
     return None
 

{cartesia_line-0.2.0.dev0 → cartesia_line-0.2.0.dev2}/line/llm_agent/scripts/test_provider.py

@@ -29,7 +29,6 @@ from line.events import (
     AgentToolCalled,
     AgentToolReturned,
     CallStarted,
-    SpecificUserTextSent,
     UserTextSent,
 )
 from line.llm_agent import (
@@ -137,7 +136,7 @@ async def test_tool_calling(model: str):
     user_message = "What's the weather in Tokyo? Also, what's 25 * 4?"
     event = UserTextSent(
         content=user_message,
-        history=[SpecificUserTextSent(content=user_message)],
+        history=[UserTextSent(content=user_message)],
     )
 
     print("User: What's the weather in Tokyo? Also, what's 25 * 4?")
@@ -209,7 +208,7 @@ async def test_web_search(model: str, search_context_size: str = "medium"):
     user_message = "What is the current weather in New York City? Search the web for this information."
     event = UserTextSent(
         content=user_message,
-        history=[SpecificUserTextSent(content=user_message)],
+        history=[UserTextSent(content=user_message)],
     )
 
     print(f"User: {user_message}")