Skip to content

runner

framewise_meet_client.runner

AppRunner

Manages the application's main event loop.

Source code in framewise_meet_client/runner.py
 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
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
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
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
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

run(app)

Run the application (blocking).

Source code in framewise_meet_client/runner.py
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
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