soprano-sdk 0.2.15__tar.gz → 0.2.17__tar.gz

{soprano_sdk-0.2.15 → soprano_sdk-0.2.17}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: soprano-sdk
-Version: 0.2.15
+Version: 0.2.17
 Summary: YAML-driven workflow engine with AI agent integration for building conversational SOPs
 Author: Arvind Thangamani
 License: MIT

{soprano_sdk-0.2.15 → soprano_sdk-0.2.17}/examples/concert_booking/concert_ticket_booking.yaml

@@ -1,6 +1,7 @@
 name: Concert Ticket Booking
 description: Manages concert ticket booking with seat selection, payment processing, and confirmation
 version: '1.0.0'
+agent_framework: "crewai"
 
 data:
   - name: bearer_token
@@ -58,7 +59,6 @@ steps:
     max_attempts: 3
     agent:
       name: Customer Name Collector
-      model: gpt-4o-mini
       initial_message: "Welcome to Concert Ticket Booking! Please provide your full name."
       instructions: >
         Extract the customer's full name from their message.
@@ -76,11 +76,19 @@ steps:
     max_attempts: 3
     agent:
       name: Concert Details Collector
-      model: gpt-4o-mini
       initial_message: "Hi {{customer_name}}! Which concert would you like to attend? Please specify the concert name."
       instructions: >
         Extract concert name from the user's message.
+
+        IMPORTANT: Use the available tools to help the user:
+        - check_concert_availability: Check if a concert is available and get details
+        - search_venue_info: Get venue information
+
+        When user mentions a concert, check its availability first before proceeding.
         Return: CONCERT_CAPTURED: [concert_name] or CANCEL_REQUEST:
+      tools:
+        - check_concert_availability
+        - search_venue_info
     transitions:
       - next: collect_seat_preference
         pattern: "CONCERT_CAPTURED:"
@@ -116,11 +124,16 @@ steps:
     max_attempts: 3
     agent:
       name: Ticket Quantity Collector
-      model: gpt-4o-mini
       initial_message: "How many {{seat_preference}} tickets would you like to book? (Maximum 8 per booking)"
       instructions: >
         Extract the number of tickets (1-8).
+
+        IMPORTANT: Use the calculate_total_price tool to show the user the total cost
+        when they specify a quantity. This helps them make an informed decision.
+
         Return: QUANTITY_CAPTURED: [ticket_quantity] or INVALID_QUANTITY:
+      tools:
+        - calculate_total_price
     transitions:
       - next: check_seat_availability
         pattern: "QUANTITY_CAPTURED:"
@@ -145,7 +158,6 @@ steps:
     max_attempts: 3
     agent:
       name: Alternative Seat Offer
-      model: gpt-4o-mini
       initial_message: >
         Sorry {{customer_name}}, {{seat_preference}} seats are not available for {{concert_name}}.
         Would you like to try a different section?
@@ -187,7 +199,6 @@ steps:
     function: booking_helpers.send_confirmation
     output: confirmation_sent
     mfa:
-      model: gpt-4o-mini
       type: REST
       payload:
         transactionType: SEND_TICKET_CONFIRMATION
@@ -203,7 +214,6 @@ steps:
     max_attempts: 3
     agent:
       name: Modification Request Collector
-      model: gpt-4o-mini
       initial_message: >
         Booking confirmed for {{concert_name}}, {{customer_name}}!
         Reference: {{booking_reference}}
@@ -242,3 +252,17 @@ outcomes:
   - id: payment_failed
     type: failure
     message: "Payment failed. Please check your payment method and try again."
+
+tool_config:
+  tools:
+    - name: check_concert_availability
+      description: Check if a concert is available for booking with dates and pricing
+      callable: concert_tools.check_concert_availability
+
+    - name: calculate_total_price
+      description: Calculate the total price for concert tickets with discounts
+      callable: concert_tools.calculate_total_price
+
+    - name: search_venue_info
+      description: Get detailed information about a concert venue
+      callable: concert_tools.search_venue_info

soprano_sdk-0.2.17/examples/concert_booking/concert_tools.py

@@ -0,0 +1,253 @@
+"""
+Concert booking tool functions for agent use
+These functions are exposed as tools to AI agents in the workflow
+"""
+from typing import Annotated, Any
+
+
+def check_concert_availability(
+    concert_name: Annotated[str, "Name of the concert to check availability for"],
+    **state: Any
+) -> str:
+    """
+    Check if a concert is available for booking with dates and pricing.
+
+    Args:
+        concert_name: Name of the concert to check
+
+    Returns:
+        String with concert availability details including dates and venue
+    """
+    # Mock concert database
+    concerts = {
+        "Coldplay": {
+            "available": True,
+            "venue": "DY Patil Stadium, Mumbai",
+            "date": "2026-03-15",
+            "seats_left": 5000,
+            "genres": ["Rock", "Pop"]
+        },
+        "AR Rahman": {
+            "available": True,
+            "venue": "Jawaharlal Nehru Stadium, Delhi",
+            "date": "2026-04-20",
+            "seats_left": 3500,
+            "genres": ["Classical", "Bollywood"]
+        },
+        "Ed Sheeran": {
+            "available": True,
+            "venue": "Phoenix Marketcity, Chennai",
+            "date": "2026-05-10",
+            "seats_left": 2000,
+            "genres": ["Pop", "Folk"]
+        },
+        "Arijit Singh": {
+            "available": True,
+            "venue": "MMRDA Grounds, Mumbai",
+            "date": "2026-06-05",
+            "seats_left": 8000,
+            "genres": ["Bollywood", "Romantic"]
+        },
+        "Imagine Dragons": {
+            "available": False,
+            "venue": "Bangalore Palace Grounds",
+            "date": "2026-02-28",
+            "seats_left": 0,
+            "genres": ["Rock", "Alternative"]
+        }
+    }
+
+    # Check if concert exists
+    concert_name_normalized = concert_name.strip()
+
+    # Try exact match first
+    concert_info = concerts.get(concert_name_normalized)
+
+    # Try case-insensitive match
+    if not concert_info:
+        for name, info in concerts.items():
+            if name.lower() == concert_name_normalized.lower():
+                concert_info = info
+                concert_name_normalized = name
+                break
+
+    if not concert_info:
+        # Concert not found
+        available_concerts = ", ".join(concerts.keys())
+        return f"Sorry, '{concert_name}' is not in our system. Available concerts: {available_concerts}"
+
+    # Return availability information
+    if concert_info["available"]:
+        return (
+            f"✓ {concert_name_normalized} is AVAILABLE!\n"
+            f"Venue: {concert_info['venue']}\n"
+            f"Date: {concert_info['date']}\n"
+            f"Seats Available: {concert_info['seats_left']}\n"
+            f"Genres: {', '.join(concert_info['genres'])}"
+        )
+    else:
+        return (
+            f"✗ {concert_name_normalized} is SOLD OUT\n"
+            f"Venue: {concert_info['venue']}\n"
+            f"Original Date: {concert_info['date']}\n"
+            f"Check back later for additional dates!"
+        )
+
+
+def calculate_total_price(
+    seat_preference: Annotated[str, "Seating section (VIP, Premium, or General)"],
+    ticket_quantity: Annotated[int, "Number of tickets to purchase"],
+    vip_price: Annotated[float, "Price per VIP ticket"],
+    premium_price: Annotated[float, "Price per Premium ticket"],
+    general_price: Annotated[float, "Price per General ticket"],
+    **state: Any
+
+) -> str:
+    """
+    Calculate the total price for concert tickets with discounts.
+
+    Args:
+        seat_preference: Seating section (VIP, Premium, General)
+        ticket_quantity: Number of tickets
+        vip_price: Price per VIP ticket
+        premium_price: Price per Premium ticket
+        general_price: Price per General ticket
+
+    Returns:
+        String with price breakdown and total
+    """
+    # Normalize seat preference
+    seat_preference = seat_preference.strip().title()
+
+    # Map seat preference to price
+    prices = {
+        'VIP': vip_price,
+        'Vip': vip_price,
+        'Premium': premium_price,
+        'General': general_price
+    }
+
+    price_per_ticket = prices.get(seat_preference, general_price)
+    subtotal = price_per_ticket * ticket_quantity
+
+    # Apply discounts based on quantity
+    discount = 0
+    discount_percent = 0
+
+    if ticket_quantity >= 5:
+        discount_percent = 10
+        discount = subtotal * 0.10
+    elif ticket_quantity >= 3:
+        discount_percent = 5
+        discount = subtotal * 0.05
+
+    total = subtotal - discount
+
+    # Build response
+    response = "💰 Price Breakdown:\n"
+    response += f"   Seat Type: {seat_preference}\n"
+    response += f"   Price per ticket: ₹{price_per_ticket:,.0f}\n"
+    response += f"   Quantity: {ticket_quantity}\n"
+    response += f"   Subtotal: ₹{subtotal:,.0f}\n"
+
+    if discount > 0:
+        response += f"   Discount ({discount_percent}%): -₹{discount:,.0f}\n"
+        response += "   ──────────────────\n"
+        response += f"   TOTAL: ₹{total:,.0f} ✨"
+    else:
+        response += "   ──────────────────\n"
+        response += f"   TOTAL: ₹{total:,.0f}"
+
+    # Add discount tip if applicable
+    if ticket_quantity < 3:
+        response += "\n\n💡 Tip: Book 3+ tickets for 5% off, or 5+ for 10% off!"
+
+    return response
+
+
+def search_venue_info(
+    venue_name: Annotated[str, "Name of the venue to search for"],
+    **state: Any
+) -> str:
+    """
+    Get detailed information about a concert venue.
+
+    Args:
+        venue_name: Name or partial name of the venue
+
+    Returns:
+        String with venue details including capacity, location, and facilities
+    """
+    # Mock venue database
+    venues = {
+        "DY Patil Stadium": {
+            "full_name": "DY Patil Stadium",
+            "location": "Navi Mumbai, Maharashtra",
+            "capacity": 55000,
+            "facilities": ["Parking", "Food Courts", "VIP Lounges", "Wheelchair Access"],
+            "transport": "Metro: Nerul Station (3km), Bus routes available",
+            "website": "www.dypstadium.com"
+        },
+        "Jawaharlal Nehru Stadium": {
+            "full_name": "Jawaharlal Nehru Stadium",
+            "location": "Delhi",
+            "capacity": 60000,
+            "facilities": ["Parking", "Metro Connectivity", "Multiple Entry Gates", "Food Stalls"],
+            "transport": "Metro: Jawaharlal Nehru Stadium (direct), Well connected by roads",
+            "website": "www.jnstadium.in"
+        },
+        "Phoenix Marketcity": {
+            "full_name": "Phoenix Marketcity Arena",
+            "location": "Chennai, Tamil Nadu",
+            "capacity": 15000,
+            "facilities": ["Mall Complex", "Restaurants", "Parking", "AC Indoor Arena"],
+            "transport": "Bus: Multiple routes, Taxi/App cabs recommended",
+            "website": "www.phoenixmarketcity.com"
+        },
+        "MMRDA Grounds": {
+            "full_name": "MMRDA Grounds (Bandra-Kurla Complex)",
+            "location": "Mumbai, Maharashtra",
+            "capacity": 45000,
+            "facilities": ["Open Air Venue", "Multiple Stages", "Food Trucks", "Parking"],
+            "transport": "Metro: BKC Station (walkable), Well connected by roads",
+            "website": "www.mmrdagrounds.com"
+        },
+        "Bangalore Palace Grounds": {
+            "full_name": "Bangalore Palace Grounds",
+            "location": "Bangalore, Karnataka",
+            "capacity": 50000,
+            "facilities": ["Historic Venue", "Spacious Grounds", "Parking", "Food Courts"],
+            "transport": "Metro: Sampige Road (2km), Easily accessible by cab",
+            "website": "www.bangalorepalace.gov.in"
+        }
+    }
+
+    # Normalize search query
+    venue_name_normalized = venue_name.strip()
+
+    # Try exact match
+    venue_info = venues.get(venue_name_normalized)
+
+    # Try case-insensitive partial match
+    if not venue_info:
+        for name, info in venues.items():
+            if venue_name_normalized.lower() in name.lower():
+                venue_info = info
+                break
+
+    if not venue_info:
+        # Venue not found
+        available_venues = ", ".join(venues.keys())
+        return f"Venue '{venue_name}' not found. Available venues: {available_venues}"
+
+    # Build detailed response
+    response = f"📍 {venue_info['full_name']}\n\n"
+    response += f"Location: {venue_info['location']}\n"
+    response += f"Capacity: {venue_info['capacity']:,} people\n\n"
+    response += "Facilities:\n"
+    for facility in venue_info['facilities']:
+        response += f"  • {facility}\n"
+    response += f"\nTransport: {venue_info['transport']}\n"
+    response += f"Website: {venue_info['website']}"
+
+    return response