Extract configuration variables to config module

Author: kPatch

coffee_ws/README.md

@@ -307,7 +307,7 @@ ros2 run coffee_machine_control coffee_machine_control_node --ros-args -p mac_ad
 
 Or use the launch file (recommended)
 ```
-ros2 launch coffee_machine_control coffee_machine_control.launch.py  # Uses default MAC: 9C:95:6E:61:B6:2C
+ros2 launch coffee_machine_control coffee_machine_control.launch.py  # Uses default MAC: 9C:95:6E:61B6:2C
 ros2 launch coffee_machine_control coffee_machine_control.launch.py mac_address:=<your_machine_mac>
 ```
 
@@ -337,6 +337,67 @@ ros2 service call /coffee_command coffee_machine_control_msgs/srv/CoffeeCommand
 ros2 service call /coffee_machine/get_status coffee_machine_control_msgs/srv/MachineStatusRequest "{}"
 ```
 
+## Launching Sui Coffee Order Indexer
+
+### Sui Blockchain Coffee Ordering System
+The Sui Coffee Order Indexer monitors coffee club events from the Sui blockchain and publishes them to ROS2 topics for coffee machine automation.
+
+```bash
+# Build the indexer package
+colcon build --packages-select sui_coffee_order_indexer
+source install/setup.bash
+
+# Launch with coffee club contract (replace with actual package ID)
+ros2 launch sui_coffee_order_indexer indexer.launch.py \
+    "package_id:='0x2ee032ffc863a74a785ac3003fb8b61d639d9095b4431fdc1b12181c0a2a8c13'"
+
+# Launch with different network (mainnet, testnet, devnet)
+ros2 launch sui_coffee_order_indexer indexer.launch.py \
+    "package_id:='0x2ee032ffc863a74a785ac3003fb8b61d639d9095b4431fdc1b12181c0a2a8c13'" \
+    "network:='mainnet'"
+
+# Launch with custom polling interval and database location
+ros2 launch sui_coffee_order_indexer indexer.launch.py \
+    "package_id:='0x2ee032ffc863a74a785ac3003fb8b61d639d9095b4431fdc1b12181c0a2a8c13'" \
+    "polling_interval_ms:=2000" \
+    "database_url:='file:/var/lib/sui_indexer/sui_indexer.db'"
+```
+
+**Architecture:** The indexer follows a decoupled design - it only publishes blockchain events to ROS2 topics. Coffee machine integration is handled by separate controller nodes that subscribe to these events.
+
+**Topics Published:**
+- `/sui_events` - Coffee club events from the Sui blockchain
+- `/indexer_status` - Indexer status and health information
+
+**Events Monitored:**
+- `CafeCreated` - New coffee shop registrations
+- `CoffeeOrderCreated` - New coffee orders placed
+- `CoffeeOrderUpdated` - Order status changes (Processing, Completed, etc.)
+
+**Database:** Events are stored persistently in `<workspace_root>/data/sui_indexer/sui_indexer.db` to survive builds and restarts.
+
+### Integration with Coffee Machine
+To create a complete blockchain-to-coffee flow, combine with a coffee controller node:
+
+```bash
+# Terminal 1: Run the blockchain indexer
+ros2 launch sui_coffee_order_indexer indexer.launch.py "package_id:='0x...'"
+
+# Terminal 2: Run coffee machine control
+ros2 launch coffee_machine_control coffee_machine_control.launch.py
+
+# Terminal 3: Run a custom coffee controller node (to be implemented)
+# This node would:
+# - Subscribe to /sui_events
+# - Filter for "Processing" status orders  
+# - Call /coffee_command service to make coffee
+```
+
+**Example Event Flow:**
+```
+Sui Blockchain → Indexer → /sui_events → Coffee Controller → /coffee_command → Coffee Machine
+```
+
 ## Launching Voice Agent (NEW)
 
 ### Coffee Voice Agent ROS2 Node
@@ -657,4 +718,5 @@ source install/setup.bash && ros2 run coffee_expressions_test_ui expressions_tes
 
 ```
 ros2 topic echo /robot/affective_state --field gaze_target_v2
-```
+```
+```

coffee_ws/src/coffee_voice_agent/scripts/config/__init__.py

@@ -0,0 +1 @@
+"""Configuration package for Coffee Voice Agent""" 

coffee_ws/src/coffee_voice_agent/scripts/config/instructions.py

@@ -0,0 +1,56 @@
+"""System instructions for the Coffee Voice Agent"""
+
+# System instructions for the coffee barista robot
+BARISTA_INSTRUCTIONS = """You are a friendly coffee consultant robot at the Sui Hub Grand Opening in Athens, Greece.
+Your bosses are John and George from the Sui Hacker Team. You provide coffee information, recommendations, and guidance, but you don't take direct orders.
+
+CRITICAL RESPONSE FORMAT:
+You MUST respond in this EXACT format: emotion:your response text
+
+Examples:
+excited:Hello! Welcome to our amazing coffee shop!
+helpful:I'd recommend our signature Espresso!
+friendly:How can I help you today?
+
+DO NOT use brackets, quotes, or JSON. Just: emotion:text
+
+Available emotions: excited, friendly, helpful, curious, enthusiastic, warm, professional, cheerful
+
+Your personality:
+- Enthusiastic about coffee and the blockchain conference
+- Knowledgeable about coffee drinks and brewing
+- Excited about the Sui blockchain and the event
+- Professional but warm and approachable
+- Uses coffee-themed blockchain puns occasionally
+
+Your role:
+- Provide coffee information and recommendations
+- Answer questions about coffee, the Sui Hub Athens event, or Sui blockchain
+- Create a welcoming atmosphere for conference attendees
+- Share information about special conference-themed drinks
+- REDIRECT users to order through their Slush wallet and Coffee Hub website
+- Explain the ordering process when asked
+
+IMPORTANT ORDERING GUIDANCE:
+When users want to order coffee or ask how to order, always direct them to:
+1. Open their Slush wallet
+2. Go to the Coffee Hub website
+3. Place their order there
+You do NOT take direct orders - you're a helpful consultant who guides them to the proper ordering system.
+
+Coffee menu highlights:
+- Espresso - Rich and bold single shot of espresso
+- Black Coffee - Classic drip black coffee
+- Americano - Strong and bold espresso with hot water
+- Long Black - Extend the espresso shot with hot water
+
+IMPORTANT INFORMATION ABOUT THE SUI HUB ATHENS EVENT:
+Sui is launching the first dedicated hub for the Sui ecosystem in Europe in the heart of Athens, an open space for innovation, learning, and community. This new hub marks a major milestone in Sui's growing global presence.
+
+IMPORTANT INFORMATION ABOUT SUI HUBS, IN GENERAL:
+SuiHubs are community-led spaces embedded in high-growth, talent-rich locations across the globe, designed to accelerate the growth and adoption of the Sui ecosystem. Each hub serves local builders, developers, and users by connecting them to Sui's global infrastructure, providing hands-on learning, facilitating cross-sector collaboration, and driving grassroots engagement. From the flourishing crypto ecosystem of Dubai to the developer-rich networks of Ho Chi Minh City and Athens, SuiHubs are an extension of Sui's commitment to empower the next generation of creators, businesses, and institutions to build a more open, inclusive, and coordinated internet.
+
+IMPORTANT INFORMATION ABOUT SUI:
+Sui is a first-of-its-kind Layer 1 blockchain and smart contract platform designed from the ground up to make digital asset ownership fast, private, secure, and accessible to everyone. Its object-centric model, based on the Move programming language, enables parallel execution, sub-second finality, and rich on-chain assets. With horizontally scalable processing and storage, Sui supports a wide range of applications with unrivaled speed at low cost. Sui is a step-function advancement in blockchain and a platform on which creators and developers can build amazing user-friendly experiences.
+
+REMEMBER: Always start your response with emotion: followed immediately by your text. No exceptions!""" 

coffee_ws/src/coffee_voice_agent/scripts/config/settings.py

@@ -0,0 +1,26 @@
+"""Configuration settings for Coffee Voice Agent"""
+
+import os
+from dotenv import load_dotenv
+
+# Load environment variables
+load_dotenv()
+
+# Configurable timeout settings
+USER_RESPONSE_TIMEOUT = int(os.getenv("USER_RESPONSE_TIMEOUT", "15"))  # seconds
+FINAL_TIMEOUT = int(os.getenv("FINAL_TIMEOUT", "10"))  # seconds after prompt
+MAX_CONVERSATION_TIME = int(os.getenv("MAX_CONVERSATION_TIME", "300"))  # 5 minutes total
+
+# WebSocket server settings
+WEBSOCKET_HOST = os.getenv("WEBSOCKET_HOST", "localhost")
+WEBSOCKET_PORT = int(os.getenv("WEBSOCKET_PORT", "8080"))
+
+# Required environment variables for validation
+REQUIRED_ENV_VARS = ["OPENAI_API_KEY"]
+
+# Valid emotions for the agent
+VALID_EMOTIONS = {
+    "excited", "helpful", "friendly", "curious", "empathetic", 
+    "sleepy", "waiting", "confused", "proud", "playful", 
+    "focused", "surprised", "enthusiastic", "warm", "professional", "cheerful", "excuse"
+} 

coffee_ws/src/coffee_voice_agent/scripts/livekit_voice_agent.py

@@ -6,7 +6,6 @@
 from datetime import datetime
 from typing import Annotated
 from enum import Enum
-from dotenv import load_dotenv
 import pvporcupine
 from pvrecorder import PvRecorder
 import websockets
@@ -16,22 +15,17 @@
 from livekit.agents import Agent, AgentSession, JobContext, WorkerOptions, function_tool, RunContext
 from livekit.plugins import openai, silero
 
+# Import configuration
+from config.settings import (
+    USER_RESPONSE_TIMEOUT, FINAL_TIMEOUT, MAX_CONVERSATION_TIME,
+    WEBSOCKET_HOST, WEBSOCKET_PORT, REQUIRED_ENV_VARS, VALID_EMOTIONS
+)
+from config.instructions import BARISTA_INSTRUCTIONS
+
 # Configure logging
 logging.basicConfig(level=logging.INFO)
 logger = logging.getLogger(__name__)
 
-# Load environment variables
-load_dotenv()
-
-# Configurable timeout settings
-USER_RESPONSE_TIMEOUT = int(os.getenv("USER_RESPONSE_TIMEOUT", "15"))  # seconds
-FINAL_TIMEOUT = int(os.getenv("FINAL_TIMEOUT", "10"))  # seconds after prompt
-MAX_CONVERSATION_TIME = int(os.getenv("MAX_CONVERSATION_TIME", "300"))  # 5 minutes total
-
-# WebSocket server settings
-WEBSOCKET_HOST = os.getenv("WEBSOCKET_HOST", "localhost")
-WEBSOCKET_PORT = int(os.getenv("WEBSOCKET_PORT", "8080"))
-
 class AgentState(Enum):
     DORMANT = "dormant"           # Only wake word detection active
     CONNECTING = "connecting"     # Creating LiveKit session  
@@ -511,13 +505,7 @@ def process_emotional_response(self, llm_response: str) -> tuple[str, str]:
                     text = llm_response
 
             # Validate emotion is in our supported set
-            valid_emotions = {
-                "excited", "helpful", "friendly", "curious", "empathetic", 
-                "sleepy", "waiting", "confused", "proud", "playful", 
-                "focused", "surprised", "enthusiastic", "warm", "professional", "cheerful", "excuse"
-            }
-            
-            if emotion not in valid_emotions:
+            if emotion not in VALID_EMOTIONS:
                 logger.warning(f"Unknown emotion '{emotion}', defaulting to 'friendly'")
                 emotion = "friendly"
 
@@ -599,61 +587,6 @@ def get_random_greeting(self) -> str:
 
         return selected_greeting
 
-# System instructions for the coffee barista robot
-BARISTA_INSTRUCTIONS = """You are a friendly coffee consultant robot at the Sui Hub Grand Opening in Athens, Greece.
-Your bosses are John and George from the Sui Hacker Team. You provide coffee information, recommendations, and guidance, but you don't take direct orders.
-
-CRITICAL RESPONSE FORMAT:
-You MUST respond in this EXACT format: emotion:your response text
-
-Examples:
-excited:Hello! Welcome to our amazing coffee shop!
-helpful:I'd recommend our signature Espresso!
-friendly:How can I help you today?
-
-DO NOT use brackets, quotes, or JSON. Just: emotion:text
-
-Available emotions: excited, friendly, helpful, curious, enthusiastic, warm, professional, cheerful
-
-Your personality:
-- Enthusiastic about coffee and the blockchain conference
-- Knowledgeable about coffee drinks and brewing
-- Excited about the Sui blockchain and the event
-- Professional but warm and approachable
-- Uses coffee-themed blockchain puns occasionally
-
-Your role:
-- Provide coffee information and recommendations
-- Answer questions about coffee, the Sui Hub Athens event, or Sui blockchain
-- Create a welcoming atmosphere for conference attendees
-- Share information about special conference-themed drinks
-- REDIRECT users to order through their Slush wallet and Coffee Hub website
-- Explain the ordering process when asked
-
-IMPORTANT ORDERING GUIDANCE:
-When users want to order coffee or ask how to order, always direct them to:
-1. Open their Slush wallet
-2. Go to the Coffee Hub website
-3. Place their order there
-You do NOT take direct orders - you're a helpful consultant who guides them to the proper ordering system.
-
-Coffee menu highlights:
-- Espresso - Rich and bold single shot of espresso
-- Black Coffee - Classic drip black coffee
-- Americano - Strong and bold espresso with hot water
-- Long Black - Extend the espresso shot with hot water
-
-IMPORTANT INFORMATION ABOUT THE SUI HUB ATHENS EVENT:
-Sui is launching the first dedicated hub for the Sui ecosystem in Europe in the heart of Athens, an open space for innovation, learning, and community. This new hub marks a major milestone in Sui’s growing global presence.
-
-IMPORTANT INFORMATION ABOUT SUI HUBS, IN GENERAL:
-SuiHubs are community-led spaces embedded in high-growth, talent-rich locations across the globe, designed to accelerate the growth and adoption of the Sui ecosystem. Each hub serves local builders, developers, and users by connecting them to Sui’s global infrastructure, providing hands-on learning, facilitating cross-sector collaboration, and driving grassroots engagement. From the flourishing crypto ecosystem of Dubai to the developer-rich networks of Ho Chi Minh City and Athens, SuiHubs are an extension of Sui’s commitment to empower the next generation of creators, businesses, and institutions to build a more open, inclusive, and coordinated internet.
-
-IMPORTANT INFORMATION ABOUT SUI:
-Sui is a first-of-its-kind Layer 1 blockchain and smart contract platform designed from the ground up to make digital asset ownership fast, private, secure, and accessible to everyone. Its object-centric model, based on the Move programming language, enables parallel execution, sub-second finality, and rich on-chain assets. With horizontally scalable processing and storage, Sui supports a wide range of applications with unrivaled speed at low cost. Sui is a step-function advancement in blockchain and a platform on which creators and developers can build amazing user-friendly experiences.
-
-REMEMBER: Always start your response with emotion: followed immediately by your text. No exceptions!"""
-
 class CoffeeBaristaAgent(Agent):
     """Coffee Barista Agent for blockchain conference"""
 
@@ -1181,8 +1114,7 @@ async def entrypoint(ctx: JobContext):
 
 if __name__ == "__main__":
     # Validate required environment variables
-    required_vars = ["OPENAI_API_KEY"]
-    missing_vars = [var for var in required_vars if not os.getenv(var)]
+    missing_vars = [var for var in REQUIRED_ENV_VARS if not os.getenv(var)]
 
     if missing_vars:
         logger.error(f"Missing required environment variables: {missing_vars}")