orka.tui.textual_screens module

Screen implementations for OrKa Textual TUI application.

class orka.tui.textual_screens.BaseOrKaScreen(data_manager, **kwargs)[source]

Bases: Screen

Base screen for OrKa application with common functionality.

compose() → Iterable[Widget][source]: Base compose method with header and footer.

compose_content() → Iterable[Widget][source]: Override this method in subclasses.

on_mount() → None[source]: Handle mounting of the screen.

refresh_data() → None[source]: Refresh screen data - override in subclasses.

can_focus: bool = False: Widget may receive focus.

can_focus_children: bool = True: Widget’s children may receive focus.

class orka.tui.textual_screens.DashboardScreen(data_manager, **kwargs)[source]

Bases: BaseOrKaScreen

Dashboard screen showing overview of memory system.

compose_content() → Iterable[Widget][source]: Compose the dashboard layout.

refresh_data() → None[source]: Refresh dashboard data.

can_focus: bool = False: Widget may receive focus.

can_focus_children: bool = True: Widget’s children may receive focus.

screen_layout_refresh_signal: Signal[Screen]: The signal that is published when the screen’s layout is refreshed.

bindings_updated_signal: Signal[Screen]: A signal published when the bindings have been updated

text_selection_started_signal: Signal[Screen]: A signal published when text selection has started.

highlight_style: Style | None

absolute_offset: Offset | None: Force an absolute offset for the widget (used by tooltips).

styles: RenderStyles

message_signal: Signal[Message]

Subscribe to this signal to be notified of all messages sent to this widget.

This is a fairly low-level mechanism, and shouldn’t replace regular message handling.

class orka.tui.textual_screens.ShortMemoryScreen(data_manager, **kwargs)[source]

Bases: BaseOrKaScreen

Screen for viewing short-term memory entries.

compose_content() → Iterable[Widget][source]: Compose the short memory layout.

on_memory_table_widget_memory_selected(message: MemorySelected) → None[source]: Handle memory selection to show content in lower panel.

refresh_data() → None[source]: Refresh short memory data.

can_focus: bool = False: Widget may receive focus.

can_focus_children: bool = True: Widget’s children may receive focus.

screen_layout_refresh_signal: Signal[Screen]: The signal that is published when the screen’s layout is refreshed.

bindings_updated_signal: Signal[Screen]: A signal published when the bindings have been updated

text_selection_started_signal: Signal[Screen]: A signal published when text selection has started.

highlight_style: Style | None

absolute_offset: Offset | None: Force an absolute offset for the widget (used by tooltips).

styles: RenderStyles

message_signal: Signal[Message]

Subscribe to this signal to be notified of all messages sent to this widget.

This is a fairly low-level mechanism, and shouldn’t replace regular message handling.

class orka.tui.textual_screens.LongMemoryScreen(data_manager, **kwargs)[source]

Bases: BaseOrKaScreen

Screen for viewing long-term memory entries.

compose_content() → Iterable[Widget][source]: Compose the long memory layout.

on_memory_table_widget_memory_selected(message: MemorySelected) → None[source]: Handle memory selection to show content in lower panel.

refresh_data() → None[source]: Refresh long memory data.

can_focus: bool = False: Widget may receive focus.

can_focus_children: bool = True: Widget’s children may receive focus.

screen_layout_refresh_signal: Signal[Screen]: The signal that is published when the screen’s layout is refreshed.

bindings_updated_signal: Signal[Screen]: A signal published when the bindings have been updated

text_selection_started_signal: Signal[Screen]: A signal published when text selection has started.

highlight_style: Style | None

absolute_offset: Offset | None: Force an absolute offset for the widget (used by tooltips).

styles: RenderStyles

message_signal: Signal[Message]

Subscribe to this signal to be notified of all messages sent to this widget.

This is a fairly low-level mechanism, and shouldn’t replace regular message handling.

class orka.tui.textual_screens.MemoryLogsScreen(data_manager, **kwargs)[source]

Bases: BaseOrKaScreen

Screen for viewing memory system logs.

compose_content() → Iterable[Widget][source]: Compose the memory logs layout.

on_memory_table_widget_memory_selected(message: MemorySelected) → None[source]: Handle log selection to show content in lower panel.

refresh_data() → None[source]: Refresh memory logs data.

can_focus: bool = False: Widget may receive focus.

can_focus_children: bool = True: Widget’s children may receive focus.

screen_layout_refresh_signal: Signal[Screen]: The signal that is published when the screen’s layout is refreshed.

bindings_updated_signal: Signal[Screen]: A signal published when the bindings have been updated

text_selection_started_signal: Signal[Screen]: A signal published when text selection has started.

highlight_style: Style | None

absolute_offset: Offset | None: Force an absolute offset for the widget (used by tooltips).

styles: RenderStyles

message_signal: Signal[Message]

Subscribe to this signal to be notified of all messages sent to this widget.

This is a fairly low-level mechanism, and shouldn’t replace regular message handling.

class orka.tui.textual_screens.HealthScreen(data_manager, **kwargs)[source]

Bases: BaseOrKaScreen

Screen for system health monitoring.

compose_content() → Iterable[Widget][source]: Compose the health monitoring layout.

refresh_data() → None[source]: Refresh health monitoring data.

can_focus: bool = False: Widget may receive focus.

can_focus_children: bool = True: Widget’s children may receive focus.

screen_layout_refresh_signal: Signal[Screen]: The signal that is published when the screen’s layout is refreshed.

bindings_updated_signal: Signal[Screen]: A signal published when the bindings have been updated

text_selection_started_signal: Signal[Screen]: A signal published when text selection has started.

highlight_style: Style | None

absolute_offset: Offset | None: Force an absolute offset for the widget (used by tooltips).

styles: RenderStyles

message_signal: Signal[Message]

Subscribe to this signal to be notified of all messages sent to this widget.

This is a fairly low-level mechanism, and shouldn’t replace regular message handling.