feat: enable workflows to be embedded in websites as a script tag (#47)

* feat: add deployment configuration options

* Simplify EmbedDialog

* Add options for inline vs floating embedding of agent

api/services/telephony/base.py

@@ -3,6 +3,7 @@ Base telephony provider interface for abstracting telephony services.
 This allows easy switching between different providers (Twilio, Vonage, etc.)
 while keeping business logic decoupled from specific implementations.
 """
+
 from abc import ABC, abstractmethod
 from dataclasses import dataclass, field
 from typing import TYPE_CHECKING, Any, Dict, List, Optional
@@ -14,10 +15,15 @@ if TYPE_CHECKING:
 @dataclass
 class CallInitiationResult:
     """Standardized response from initiate_call across all providers."""
-    call_id: str                          # Provider's call identifier (SID for Twilio, UUID for Vonage)
-    status: str                            # Initial status (e.g., "queued", "initiated", "started")
-    provider_metadata: Dict[str, Any] = field(default_factory=dict)  # Data that needs to be persisted
-    raw_response: Dict[str, Any] = field(default_factory=dict)       # Full provider response for debugging
+
+    call_id: str  # Provider's call identifier (SID for Twilio, UUID for Vonage)
+    status: str  # Initial status (e.g., "queued", "initiated", "started")
+    provider_metadata: Dict[str, Any] = field(
+        default_factory=dict
+    )  # Data that needs to be persisted
+    raw_response: Dict[str, Any] = field(
+        default_factory=dict
+    )  # Full provider response for debugging
 
 
 class TelephonyProvider(ABC):
@@ -25,6 +31,7 @@ class TelephonyProvider(ABC):
     Abstract base class for telephony providers.
     All telephony providers must implement these core methods.
     """
+
     PROVIDER_NAME = None
     WEBHOOK_ENDPOINT = None
 
@@ -38,13 +45,13 @@ class TelephonyProvider(ABC):
     ) -> CallInitiationResult:
         """
         Initiate an outbound call.
-        
+
         Args:
             to_number: The destination phone number
             webhook_url: The URL to receive call events
             workflow_run_id: Optional workflow run ID for tracking
             **kwargs: Provider-specific additional parameters
-            
+
         Returns:
             CallInitiationResult with standardized call details
         """
@@ -54,10 +61,10 @@ class TelephonyProvider(ABC):
     async def get_call_status(self, call_id: str) -> Dict[str, Any]:
         """
         Get the current status of a call.
-        
+
         Args:
             call_id: The provider-specific call identifier
-            
+
         Returns:
             Dict containing call status information
         """
@@ -67,7 +74,7 @@ class TelephonyProvider(ABC):
     async def get_available_phone_numbers(self) -> List[str]:
         """
         Get list of available phone numbers for this provider.
-        
+
         Returns:
             List of phone numbers that can be used for outbound calls
         """
@@ -77,7 +84,7 @@ class TelephonyProvider(ABC):
     def validate_config(self) -> bool:
         """
         Validate that the provider is properly configured.
-        
+
         Returns:
             True if configuration is valid, False otherwise
         """
@@ -89,12 +96,12 @@ class TelephonyProvider(ABC):
     ) -> bool:
         """
         Verify webhook signature for security.
-        
+
         Args:
             url: The webhook URL
             params: The webhook parameters
             signature: The signature to verify
-            
+
         Returns:
             True if signature is valid, False otherwise
         """
@@ -106,12 +113,12 @@ class TelephonyProvider(ABC):
     ) -> str:
         """
         Generate the initial webhook response for starting a call session.
-        
+
         Args:
             workflow_id: The workflow ID
             user_id: The user ID
             workflow_run_id: The workflow run ID
-            
+
         Returns:
             Provider-specific response (e.g., TwiML for Twilio)
         """
@@ -121,10 +128,10 @@ class TelephonyProvider(ABC):
     async def get_call_cost(self, call_id: str) -> Dict[str, Any]:
         """
         Get cost information for a completed call.
-        
+
         Args:
             call_id: Provider-specific call identifier (SID for Twilio, UUID for Vonage)
-            
+
         Returns:
             Dict containing:
                 - cost_usd: The cost in USD as float
@@ -138,10 +145,10 @@ class TelephonyProvider(ABC):
     def parse_status_callback(self, data: Dict[str, Any]) -> Dict[str, Any]:
         """
         Parse provider-specific status callback data into generic format.
-        
+
         Args:
             data: Raw callback data from the provider
-            
+
         Returns:
             Dict with standardized fields:
                 - call_id: Provider's call identifier
@@ -163,14 +170,14 @@ class TelephonyProvider(ABC):
     ) -> None:
         """
         Handle provider-specific WebSocket connection for real-time call audio.
-        
+
         This method encapsulates all provider-specific WebSocket handshake and
         message routing logic, keeping the main websocket endpoint clean.
-        
+
         Args:
             websocket: The WebSocket connection
             workflow_id: The workflow ID
             user_id: The user ID
             workflow_run_id: The workflow run ID
         """
-        pass
+        pass