Skip to content

runner

framewise_meet_client.runner

AppRunner

Manages the application's main event loop.

Source code in framewise_meet_client/runner.py
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
class AppRunner:
    """Manages the application's main event loop."""

    # Message type mapping
    _message_classes = {
        "on_join": JoinMessage,
        "on_exit": ExitMessage,
        "transcript": TranscriptMessage,
        "custom_ui_element_response": CustomUIElementMessage,
        "mcq_selection": MCQSelectionMessage,
        "connection_rejected": ConnectionRejectedMessage
    }

    def __init__(self, connection, event_dispatcher, auto_reconnect=True, reconnect_delay=5):
        """Initialize the app runner.

        Args:
            connection: WebSocketConnection instance
            event_dispatcher: EventDispatcher instance
            auto_reconnect: Whether to automatically reconnect on disconnect
            reconnect_delay: Delay between reconnection attempts in seconds
        """
        self.connection = connection
        self.event_dispatcher = event_dispatcher
        self.auto_reconnect = auto_reconnect
        self.reconnect_delay = reconnect_delay

    def _convert_message(self, message_type: str, data: Dict[str, Any]) -> Optional[BaseMessage]:
        """Convert raw message data to appropriate message object.

        Args:
            message_type: Type of message
            data: Raw message data

        Returns:
            Converted message object or None if conversion failed
        """
        message_class = self._message_classes.get(message_type)
        if not message_class:
            return None

        try:
            logger.debug(f"Converting raw data to {message_class.__name__}")
            return message_class.model_validate(data)
        except ValidationError as e:
            logger.warning(f"Validation error converting {message_type}: {e}")
            return None
        except Exception as e:
            logger.warning(f"Unexpected error converting {message_type}: {e}")
            return None

    async def _listen(self) -> None:
        """Listen for incoming messages and dispatch to handlers."""
        try:
            while self.connection.connected:
                data = await self.connection.receive()

                logger.info(data)
                if "type" not in data:
                    logger.warning("Received message without type field")
                    continue

                message_type = data["type"]

                # Special handling for connection_rejected messages
                if message_type == "connection_rejected":
                    rejected_message = ConnectionRejectedMessage.model_validate(data)
                    logger.warning(f"Connection rejected: {rejected_message.content.reason}")
                    await self.event_dispatcher.dispatch("connection_rejected", rejected_message)

                    # Stop the connection if rejected
                    self.app.running = False
                    break

                # Always try to convert every message to its proper type
                converted = None
                message_class = self._message_classes.get(message_type)

                if message_class is not None:
                    try:
                        converted = message_class.model_validate(data)
                        logger.debug(f"Successfully converted to {message_class.__name__}")
                    except Exception as e:
                        logger.warning(f"Failed to convert {message_type} to {message_class.__name__}: {e}")

                # Dispatch the converted message if available, raw data otherwise
                await self.event_dispatcher.dispatch(message_type, converted or data)

                # Handle special events
                if message_type == "transcript":
                    # Check if this is a final transcript
                    is_final = False
                    if converted and isinstance(converted, TranscriptMessage):
                        is_final = converted.content.is_final
                    elif isinstance(data, dict):
                        try:
                            is_final = data.get("content", {}).get("is_final", False)
                        except:
                            pass

                    if is_final:
                        logger.debug("Final transcript detected, triggering invoke event")
                        await self.event_dispatcher.dispatch(INVOKE_EVENT, converted or data)

                # Handle UI subtypes
                elif message_type == "custom_ui_element_response":
                    ui_subtype = None
                    if converted and isinstance(converted, CustomUIElementMessage):
                        ui_subtype = converted.content.type
                    elif isinstance(data, dict):
                        try:
                            ui_subtype = data.get("content", {}).get("type")
                        except:
                            pass

                    if ui_subtype:
                        logger.debug(f"Dispatching to UI subtype: {ui_subtype}")
                        await self.event_dispatcher.dispatch(ui_subtype, converted or data)

        except ConnectionError as e:
            logger.warning(f"Connection error: {str(e)}")

    async def _main_loop(self) -> None:
        """Main application loop."""
        try:
            while self.app.running:
                try:
                    await self.connection.connect()
                    await self._listen()
                except Exception as e:
                    logger.error(f"Connection error: {str(e)}")

                if not self.auto_reconnect or not self.app.running:
                    break

                logger.info(f"Reconnecting in {self.reconnect_delay} seconds...")
                await asyncio.sleep(self.reconnect_delay)

        finally:
            # Clean up on exit
            if self.connection.connected:
                await self.connection.disconnect()

    def _handle_signal(self, sig, frame):
        """Handle termination signals."""
        logger.info(f"Received signal {sig}, shutting down...")
        self.app.stop()

    def run(self, app):
        """Run the application (blocking)."""
        self.app = app

        # Set up signal handlers for graceful shutdown
        signal.signal(signal.SIGINT, self._handle_signal)
        signal.signal(signal.SIGTERM, self._handle_signal)

        # Create a new event loop in this thread
        self.app.loop = asyncio.new_event_loop()
        asyncio.set_event_loop(self.app.loop)

        try:
            self.app.running = True
            self.app._main_task = self.app.loop.create_task(self._main_loop())
            self.app.loop.run_until_complete(self.app._main_task)
        except KeyboardInterrupt:
            logger.info("Application stopped by user")
        finally:
            # Clean up
            self.app.running = False

            # Cancel the main task if it's still running
            if self.app._main_task and not self.app._main_task.done():
                self.app._main_task.cancel()
                try:
                    self.app.loop.run_until_complete(self.app._main_task)
                except asyncio.CancelledError:
                    pass

            # Close the event loop
            self.app.loop.close()
            self.app.loop = None

__init__(connection, event_dispatcher, auto_reconnect=True, reconnect_delay=5)

Initialize the app runner.

Parameters:

Name Type Description Default
connection

WebSocketConnection instance

required
event_dispatcher

EventDispatcher instance

required
auto_reconnect

Whether to automatically reconnect on disconnect

True
reconnect_delay

Delay between reconnection attempts in seconds

5
Source code in framewise_meet_client/runner.py
30
31
32
33
34
35
36
37
38
39
40
41
42
def __init__(self, connection, event_dispatcher, auto_reconnect=True, reconnect_delay=5):
    """Initialize the app runner.

    Args:
        connection: WebSocketConnection instance
        event_dispatcher: EventDispatcher instance
        auto_reconnect: Whether to automatically reconnect on disconnect
        reconnect_delay: Delay between reconnection attempts in seconds
    """
    self.connection = connection
    self.event_dispatcher = event_dispatcher
    self.auto_reconnect = auto_reconnect
    self.reconnect_delay = reconnect_delay

_convert_message(message_type, data)

Convert raw message data to appropriate message object.

Parameters:

Name Type Description Default
message_type str

Type of message

required
data Dict[str, Any]

Raw message data

required

Returns:

Type Description
Optional[BaseMessage]

Converted message object or None if conversion failed

Source code in framewise_meet_client/runner.py
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
def _convert_message(self, message_type: str, data: Dict[str, Any]) -> Optional[BaseMessage]:
    """Convert raw message data to appropriate message object.

    Args:
        message_type: Type of message
        data: Raw message data

    Returns:
        Converted message object or None if conversion failed
    """
    message_class = self._message_classes.get(message_type)
    if not message_class:
        return None

    try:
        logger.debug(f"Converting raw data to {message_class.__name__}")
        return message_class.model_validate(data)
    except ValidationError as e:
        logger.warning(f"Validation error converting {message_type}: {e}")
        return None
    except Exception as e:
        logger.warning(f"Unexpected error converting {message_type}: {e}")
        return None

_listen() async

Listen for incoming messages and dispatch to handlers.

Source code in framewise_meet_client/runner.py
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
async def _listen(self) -> None:
    """Listen for incoming messages and dispatch to handlers."""
    try:
        while self.connection.connected:
            data = await self.connection.receive()

            logger.info(data)
            if "type" not in data:
                logger.warning("Received message without type field")
                continue

            message_type = data["type"]

            # Special handling for connection_rejected messages
            if message_type == "connection_rejected":
                rejected_message = ConnectionRejectedMessage.model_validate(data)
                logger.warning(f"Connection rejected: {rejected_message.content.reason}")
                await self.event_dispatcher.dispatch("connection_rejected", rejected_message)

                # Stop the connection if rejected
                self.app.running = False
                break

            # Always try to convert every message to its proper type
            converted = None
            message_class = self._message_classes.get(message_type)

            if message_class is not None:
                try:
                    converted = message_class.model_validate(data)
                    logger.debug(f"Successfully converted to {message_class.__name__}")
                except Exception as e:
                    logger.warning(f"Failed to convert {message_type} to {message_class.__name__}: {e}")

            # Dispatch the converted message if available, raw data otherwise
            await self.event_dispatcher.dispatch(message_type, converted or data)

            # Handle special events
            if message_type == "transcript":
                # Check if this is a final transcript
                is_final = False
                if converted and isinstance(converted, TranscriptMessage):
                    is_final = converted.content.is_final
                elif isinstance(data, dict):
                    try:
                        is_final = data.get("content", {}).get("is_final", False)
                    except:
                        pass

                if is_final:
                    logger.debug("Final transcript detected, triggering invoke event")
                    await self.event_dispatcher.dispatch(INVOKE_EVENT, converted or data)

            # Handle UI subtypes
            elif message_type == "custom_ui_element_response":
                ui_subtype = None
                if converted and isinstance(converted, CustomUIElementMessage):
                    ui_subtype = converted.content.type
                elif isinstance(data, dict):
                    try:
                        ui_subtype = data.get("content", {}).get("type")
                    except:
                        pass

                if ui_subtype:
                    logger.debug(f"Dispatching to UI subtype: {ui_subtype}")
                    await self.event_dispatcher.dispatch(ui_subtype, converted or data)

    except ConnectionError as e:
        logger.warning(f"Connection error: {str(e)}")

_main_loop() async

Main application loop.

Source code in framewise_meet_client/runner.py
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
async def _main_loop(self) -> None:
    """Main application loop."""
    try:
        while self.app.running:
            try:
                await self.connection.connect()
                await self._listen()
            except Exception as e:
                logger.error(f"Connection error: {str(e)}")

            if not self.auto_reconnect or not self.app.running:
                break

            logger.info(f"Reconnecting in {self.reconnect_delay} seconds...")
            await asyncio.sleep(self.reconnect_delay)

    finally:
        # Clean up on exit
        if self.connection.connected:
            await self.connection.disconnect()

_handle_signal(sig, frame)

Handle termination signals.

Source code in framewise_meet_client/runner.py
160
161
162
163
def _handle_signal(self, sig, frame):
    """Handle termination signals."""
    logger.info(f"Received signal {sig}, shutting down...")
    self.app.stop()

run(app)

Run the application (blocking).

Source code in framewise_meet_client/runner.py
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
def run(self, app):
    """Run the application (blocking)."""
    self.app = app

    # Set up signal handlers for graceful shutdown
    signal.signal(signal.SIGINT, self._handle_signal)
    signal.signal(signal.SIGTERM, self._handle_signal)

    # Create a new event loop in this thread
    self.app.loop = asyncio.new_event_loop()
    asyncio.set_event_loop(self.app.loop)

    try:
        self.app.running = True
        self.app._main_task = self.app.loop.create_task(self._main_loop())
        self.app.loop.run_until_complete(self.app._main_task)
    except KeyboardInterrupt:
        logger.info("Application stopped by user")
    finally:
        # Clean up
        self.app.running = False

        # Cancel the main task if it's still running
        if self.app._main_task and not self.app._main_task.done():
            self.app._main_task.cancel()
            try:
                self.app.loop.run_until_complete(self.app._main_task)
            except asyncio.CancelledError:
                pass

        # Close the event loop
        self.app.loop.close()
        self.app.loop = None