Enum CassMsg 

pub enum CassMsg {
    TerminalEvent(TerminalEventPayload),
    QueryChanged(String),
    QueryCleared,
    QueryLineKilled,
    QueryForwardKilled,
    QueryWordDeleted,
    QuerySubmitted,
    SearchRequested,
    SearchMoreRequested,
    SearchCompleted {
        generation: u64,
        pass: SearchPass,
        requested_limit: usize,
        hits: Vec<SearchHit>,
        elapsed_ms: u128,
        suggestions: Vec<QuerySuggestion>,
        wildcard_fallback: bool,
        append: bool,
    },
    SearchFailed {
        generation: u64,
        error: String,
    },
    SearchRefinementFailed {
        generation: u64,
        latency_ms: u128,
        error: String,
    },
    SearchStreamFinished {
        generation: u64,
    },
    CursorMoved {
        delta: i32,
    },
    CursorWordMoved {
        forward: bool,
    },
    DeleteForward,
    CursorJumped {
        to_end: bool,
    },
    WildcardFallbackToggled,
    FilterAgentSet(HashSet<String>),
    FilterWorkspaceSet(HashSet<String>),
    FilterTimeSet {
        from: Option<i64>,
        to: Option<i64>,
    },
    FilterSourceSet(SourceFilter),
    FiltersClearAll,
    TimePresetCycled,
    SourceFilterCycled,
    SearchModeCycled,
    MatchModeCycled,
    RankingModeCycled,
    ContextWindowCycled,
    DensityModeCycled,
    ThemeToggled,
    ThemePreviousToggled,
    SelectionMoved {
        delta: i32,
    },
    SelectionJumped {
        to_end: bool,
    },
    ActivePaneChanged {
        index: usize,
    },
    FocusToggled,
    FocusDirectional {
        direction: FocusDirection,
    },
    DetailScrolled {
        delta: i32,
    },
    PageScrolled {
        delta: i32,
    },
    Undo,
    Redo,
    GroupingCycled,
    TimelineJumped {
        forward: bool,
    },
    DetailOpened,
    DetailLoadRequested {
        hit: SearchHit,
    },
    DetailClosed,
    DetailTabChanged(DetailTab),
    DetailWrapToggled,
    DetailPaneToggled,
    DetailFindToggled,
    DetailFindQueryChanged(String),
    DetailFindNavigated {
        forward: bool,
    },
    DetailSessionHitNavigated {
        forward: bool,
    },
    ToggleJsonView,
    ToolCollapseToggled(usize),
    ToolExpandAll,
    ToolCollapseAll,
    DetailMessageJumped {
        forward: bool,
        user_only: bool,
    },
    StatsBarToggled,
    SelectionToggled,
    SelectAllToggled,
    ItemEnqueued,
    BulkActionsOpened,
    BulkActionsClosed,
    BulkActionExecuted {
        action_index: usize,
    },
    CopySnippet,
    CopyPath,
    CopyContent,
    CopyQuery,
    OpenInEditor,
    OpenInNano,
    OpenAllQueued,
    ViewRaw,
    PeekToggled,
    ResultsRefreshed,
    PaneFilterOpened,
    PaneFilterChanged(String),
    PaneFilterClosed {
        apply: bool,
    },
    InputModeEntered(InputMode),
    InputBufferChanged(String),
    InputModeApplied,
    InputModeCancelled,
    InputAutoCompleted,
    HistoryNavigated {
        forward: bool,
    },
    HistoryCycled,
    PaletteOpened,
    PaletteClosed,
    PaletteQueryChanged(String),
    PaletteSelectionMoved {
        delta: i32,
    },
    PaletteActionExecuted,
    PaletteEvidenceToggled,
    PaletteBenchToggled,
    PaletteMatchModeCycled,
    InspectorToggled,
    InspectorTabCycled,
    InspectorModeCycled,
    CockpitModeToggled,
    CockpitExpandToggled,
    HelpToggled,
    HelpScrolled {
        delta: i32,
    },
    HelpPinToggled,
    ExportModalOpened,
    ExportModalClosed,
    ExportFieldChanged {
        field: ExportField,
        value: String,
    },
    ExportFieldToggled(ExportField),
    ExportFocusMoved {
        forward: bool,
    },
    ExportExecuted,
    ExportMarkdownExecuted,
    ExportProgressUpdated(ExportProgress),
    ExportCompleted {
        output_path: PathBuf,
        file_size: usize,
        encrypted: bool,
    },
    ExportFailed(String),
    ConsentDialogOpened,
    ConsentDialogClosed,
    ModelDownloadAccepted,
    ModelDownloadProgress {
        bytes_downloaded: u64,
        total: u64,
    },
    ModelDownloadCompleted,
    ModelDownloadFailed(String),
    ModelDownloadCancelled,
    HashModeAccepted,
    SourceFilterMenuToggled,
    SourceFilterSelected(SourceFilter),
    UpdateCheckCompleted(UpdateInfo),
    UpdateUpgradeRequested,
    UpdateSkipped,
    UpdateReleaseNotesRequested,
    UpdateDismissed,
    SuggestionApplied(u8),
    BordersToggled,
    PaneGrew,
    PaneShrunk,
    SavedViewsOpened,
    SavedViewsClosed,
    SavedViewsSelectionMoved {
        delta: i32,
    },
    SavedViewLoadedSelected,
    SavedViewRenameStarted,
    SavedViewRenameCommitted,
    SavedViewDeletedSelected,
    SavedViewsCleared,
    ViewSaved(u8),
    ViewLoaded(u8),
    IndexRefreshRequested,
    IndexProgress {
        processed: usize,
        total: usize,
        new_items: usize,
    },
    IndexRefreshCompleted,
    IndexRefreshFailed(String),
    StateLoadRequested,
    StateLoaded(Box<PersistedState>),
    StateLoadFailed(String),
    StateSaveRequested,
    StateSaved(u64),
    StateSaveFailed {
        save_token: u64,
        err: String,
    },
    StateResetRequested,
    ToastShown {
        message: String,
        toast_type: ToastType,
    },
    ToastTick,
    Resized {
        width: u16,
        height: u16,
    },
    TerminalFocusChanged(bool),
    Tick,
    MouseEvent {
        kind: MouseEventKind,
        x: u16,
        y: u16,
    },
    AnalyticsEntered,
    AnalyticsLoadRequested,
    AnalyticsChartDataLoaded(Box<AnalyticsChartData>),
    AnalyticsChartDataFailed(String),
    AnalyticsViewChanged(AnalyticsView),
    ViewStackPopped,
    AnalyticsTimeRangeSet {
        since_ms: Option<i64>,
        until_ms: Option<i64>,
    },
    AnalyticsAgentFilterSet(HashSet<String>),
    AnalyticsWorkspaceFilterSet(HashSet<String>),
    AnalyticsSourceFilterSet(SourceFilter),
    AnalyticsFiltersClearAll,
    AnalyticsDrilldown(DrilldownContext),
    AnalyticsSelectionMoved {
        delta: i32,
    },
    ExplorerMetricCycled {
        forward: bool,
    },
    ExplorerOverlayCycled,
    ExplorerGroupByCycled {
        forward: bool,
    },
    ExplorerZoomCycled {
        forward: bool,
    },
    BreakdownTabCycled {
        forward: bool,
    },
    HeatmapMetricCycled {
        forward: bool,
    },
    SwarmEntered,
    SourcesEntered,
    SourcesRefreshed,
    SourceSyncRequested(String),
    SourceSyncCompleted {
        report: SyncReport,
    },
    SourceDoctorRequested(String),
    SourceDoctorCompleted {
        source_name: String,
        passed: usize,
        warnings: usize,
        failed: usize,
    },
    SourcesSelectionMoved {
        delta: i32,
    },
    ScreenshotRequested(ScreenshotFormat),
    ScreenshotCompleted(PathBuf),
    ScreenshotFailed(String),
    MacroRecordingToggled,
    MacroRecordingSaved(PathBuf),
    MacroRecordingFailed(String),
    QuitRequested,
    ForceQuit,
}

Messages that drive the cass TUI state machine.

Every user action, system event, and async completion maps to exactly one variant. The CassApp::update() function pattern-matches on these to produce pure state transitions + side-effect commands.

Variants

TerminalEvent(TerminalEventPayload)

Raw terminal event (key, mouse, resize, paste, tick). The update() function converts this into more specific messages.

QueryChanged(String)

User typed or edited the query string.

QueryCleared

User cleared the entire query line (Ctrl+L).

QueryLineKilled

User killed text left of cursor (Ctrl+U, Unix line-kill).

QueryForwardKilled

User killed text right of cursor (Ctrl+K, Unix forward-kill).

QueryWordDeleted

User deleted word-backward (Ctrl+W).

QuerySubmitted

User pressed Enter to submit the query (force immediate search, push to history).

SearchRequested

Search execution requested (Enter or debounce expired).

SearchMoreRequested

Load the next page of results for the current query (infinite scroll).

SearchCompleted

Async search completed with results.

Fields

generation: u64

Monotonic generation id so stale async completions can be ignored.

pass: SearchPass

requested_limit: usize

hits: Vec<SearchHit>

elapsed_ms: u128

suggestions: Vec<QuerySuggestion>

wildcard_fallback: bool

append: bool

When true, append hits to the existing result set instead of replacing it.

SearchFailed

Search failed with an error message.

Fields

generation: u64

error: String

SearchRefinementFailed

Refinement failed after initial live results were already displayed.

Fields

generation: u64

latency_ms: u128

error: String

SearchStreamFinished

Live progressive stream fully completed or was cancelled.

Fields

generation: u64

CursorMoved

Move cursor within the query string (Left/Right arrow keys).

Fields

delta: i32

CursorWordMoved

Move cursor by word boundary (Ctrl+Left/Right).

Fields

forward: bool

DeleteForward

Delete the character after the cursor (Del key).

CursorJumped

Jump cursor to start or end of query (Home/End keys).

Fields

to_end: bool

WildcardFallbackToggled

Toggle the wildcard fallback indicator (Ctrl+F).

FilterAgentSet(HashSet<String>)

Agent filter added or changed.

FilterWorkspaceSet(HashSet<String>)

Workspace filter added or changed.

FilterTimeSet

Time range filter set.

Fields

from: Option<i64>

to: Option<i64>

FilterSourceSet(SourceFilter)

Source filter changed.

FiltersClearAll

All filters cleared.

TimePresetCycled

Cycle time filter preset (All -> Today -> Week -> Month -> All).

SourceFilterCycled

Cycle source filter (All -> Local -> Remote -> All).

SearchModeCycled

Cycle search mode (Hybrid -> Lexical -> Semantic).

MatchModeCycled

Cycle match mode (Standard <-> Prefix).

RankingModeCycled

Cycle ranking mode through all 6 variants.

ContextWindowCycled

Cycle context window (S -> M -> L -> XL).

DensityModeCycled

Cycle density mode (Compact -> Cozy -> Spacious).

ThemeToggled

Cycle through all built-in theme presets.

ThemePreviousToggled

Cycle to the previous theme preset (Shift+F2).

SelectionMoved

Move selection in the results pane.

Fields

delta: i32

SelectionJumped

Jump to first or last result.

Fields

to_end: bool

ActivePaneChanged

Change active pane.

Fields

index: usize

FocusToggled

Toggle focus between Results and Detail.

FocusDirectional

Move focus in a specific direction.

Fields

direction: FocusDirection

DetailScrolled

Scroll the detail pane.

Fields

delta: i32

PageScrolled

Page-level scroll.

Fields

delta: i32

Undo

Undo the last query/filter change (Ctrl+Z).

Redo

Redo the last undone change (Ctrl+Y).

GroupingCycled

Cycle the results grouping mode (Agent → Conversation → Workspace → Flat).

TimelineJumped

Jump to the next/previous day boundary in results.

Fields

forward: bool

DetailOpened

Open the detail modal for the currently selected result.

DetailLoadRequested

Load full conversation detail for the selected search hit.

Fields

hit: SearchHit

DetailClosed

Close the detail modal.

DetailTabChanged(DetailTab)

Switch detail tab.

DetailWrapToggled

Toggle text wrap in detail view.

DetailPaneToggled

Toggle detail preview pane visibility (Alt+D).

DetailFindToggled

Enter/exit inline find mode in detail.

DetailFindQueryChanged(String)

Update the detail find query.

DetailFindNavigated

Move to next/previous find match.

Fields

forward: bool

DetailSessionHitNavigated

Move to next/previous session search hit in contextual Messages view.

Fields

forward: bool

ToggleJsonView

Toggle JSON viewer tab (syntax-highlighted tree view).

ToolCollapseToggled(usize)

Toggle collapse for a tool/system message at the given index.

ToolExpandAll

Expand all collapsed tool/system messages.

ToolCollapseAll

Collapse all tool/system messages.

DetailMessageJumped

Jump to the next/previous message in the detail view.

Fields

forward: bool

user_only: bool

StatsBarToggled

Toggle the aggregate stats bar in the results pane (Ctrl+S).

SelectionToggled

Toggle select on the current item.

SelectAllToggled

Select or deselect all items in the current pane.

ItemEnqueued

Enqueue current item and advance to next.

BulkActionsOpened

Open bulk actions modal.

BulkActionsClosed

Close bulk actions modal.

BulkActionExecuted

Execute a bulk action.

Fields

action_index: usize

CopySnippet

Copy the current snippet to clipboard.

CopyPath

Copy the current source path to clipboard.

CopyContent

Copy the rendered detail content to clipboard.

CopyQuery

Copy the current search query to clipboard.

OpenInEditor

Open the current result in $EDITOR.

OpenInNano

Open content in nano.

OpenAllQueued

Open all enqueued items in $EDITOR.

ViewRaw

View raw source file.

PeekToggled

Peek XL context (toggle).

ResultsRefreshed

Refresh results (re-run current query).

PaneFilterOpened

Enter pane-local filter mode.

PaneFilterChanged(String)

Update pane filter text.

PaneFilterClosed

Apply or cancel pane filter.

Fields

apply: bool

InputModeEntered(InputMode)

Enter a specific input mode (Agent, Workspace, DateFrom, DateTo).

InputBufferChanged(String)

Update the ephemeral input buffer.

InputModeApplied

Apply the current input buffer as a filter and return to Query mode.

InputModeCancelled

Cancel input mode and return to Query mode.

InputAutoCompleted

Auto-complete the input buffer to the first suggestion.

HistoryNavigated

Navigate query history.

Fields

forward: bool

HistoryCycled

Cycle through history (Ctrl+R).

PaletteOpened

Open the command palette.

PaletteClosed

Close the command palette.

PaletteQueryChanged(String)

Update the palette search query.

PaletteSelectionMoved

Move palette selection.

Fields

delta: i32

PaletteActionExecuted

Execute the selected palette action.

PaletteEvidenceToggled

Toggle the palette evidence ledger panel.

PaletteBenchToggled

Toggle palette micro-bench mode for latency profiling.

PaletteMatchModeCycled

Cycle the palette match-type filter (F9 while palette is open).

InspectorToggled

Toggle the inspector debug overlay (Ctrl+Shift+I).

InspectorTabCycled

Cycle the active inspector tab (Timing → Layout → HitRegions).

InspectorModeCycled

Cycle the ftui inspector mode (Off → HitRegions → WidgetBounds → Full).

CockpitModeToggled

Toggle cockpit mode on/off within the inspector overlay.

CockpitExpandToggled

Toggle cockpit between overlay and expanded display modes.

HelpToggled

Toggle the help overlay.

HelpScrolled

Scroll the help overlay.

Fields

delta: i32

HelpPinToggled

Toggle help strip pinned state.

ExportModalOpened

Open the export modal.

ExportModalClosed

Close the export modal.

ExportFieldChanged

Update an export modal field.

Fields

field: ExportField

value: String

ExportFieldToggled(ExportField)

Toggle an export modal checkbox.

ExportFocusMoved

Move focus within the export modal.

Fields

forward: bool

ExportExecuted

Execute the export.

ExportMarkdownExecuted

Quick-export the current session as Markdown.

ExportProgressUpdated(ExportProgress)

Export progress update from background task.

ExportCompleted

Export completed successfully.

Fields

output_path: PathBuf

file_size: usize

encrypted: bool

ExportFailed(String)

Export failed.

ConsentDialogOpened

Open the consent dialog.

ConsentDialogClosed

Close the consent dialog.

ModelDownloadAccepted

User accepted model download.

ModelDownloadProgress

Model download progress update.

Fields

bytes_downloaded: u64

total: u64

ModelDownloadCompleted

Model download completed.

ModelDownloadFailed(String)

Model download failed.

ModelDownloadCancelled

User cancelled the active download.

HashModeAccepted

User accepted hash mode fallback (no ML model).

SourceFilterMenuToggled

Toggle the source filter popup menu.

SourceFilterSelected(SourceFilter)

Select a source filter from the menu.

UpdateCheckCompleted(UpdateInfo)

Update check completed.

UpdateUpgradeRequested

User chose to upgrade.

UpdateSkipped

User chose to skip this version.

UpdateReleaseNotesRequested

User chose to view release notes.

UpdateDismissed

User dismissed the update banner.

SuggestionApplied(u8)

Apply a did-you-mean suggestion by index (1, 2, or 3).

BordersToggled

Toggle fancy/plain borders.

PaneGrew

Grow the pane item count.

PaneShrunk

Shrink the pane item count.

SavedViewsOpened

Open saved views manager modal.

SavedViewsClosed

Close saved views manager modal.

SavedViewsSelectionMoved

Move selection in saved views modal.

Fields

delta: i32

SavedViewLoadedSelected

Load currently selected saved view.

SavedViewRenameStarted

Enter rename mode for selected saved view.

SavedViewRenameCommitted

Commit rename for selected saved view.

SavedViewDeletedSelected

Delete selected saved view slot.

SavedViewsCleared

Clear all saved view slots.

ViewSaved(u8)

Save current view to a slot (1-9).

ViewLoaded(u8)

Load a saved view from a slot (1-9).

IndexRefreshRequested

User requested index refresh.

IndexProgress

Index progress update.

Fields

processed: usize

total: usize

new_items: usize

IndexRefreshCompleted

Index refresh completed.

IndexRefreshFailed(String)

Index refresh failed.

StateLoadRequested

Load persisted state from disk.

StateLoaded(Box<PersistedState>)

Persisted state loaded.

StateLoadFailed(String)

Persisted state load failed.

StateSaveRequested

Save current state to disk.

StateSaved(u64)

Persisted state save completed.

StateSaveFailed

Persisted state save failed.

Fields

save_token: u64

err: String

StateResetRequested

Reset all persisted state to defaults.

ToastShown

Show a toast notification.

Fields

message: String

toast_type: ToastType

ToastTick

Dismiss expired toasts (called on tick).

Resized

Terminal resized.

Fields

width: u16

height: u16

TerminalFocusChanged(bool)

Terminal focus gained or lost.

Tick

Periodic tick for animations and debounce.

MouseEvent

Mouse event with coordinates.

Fields

kind: MouseEventKind

x: u16

y: u16

AnalyticsEntered

Switch to analytics surface (pushes Search onto back-stack).

AnalyticsLoadRequested

Deferred analytics data load (lets UI render a loading frame first).

AnalyticsChartDataLoaded(Box<AnalyticsChartData>)

Async analytics chart data loaded successfully.

AnalyticsChartDataFailed(String)

Async analytics chart data load failed.

AnalyticsViewChanged(AnalyticsView)

Navigate to a specific analytics subview.

ViewStackPopped

Pop the view stack (Esc from analytics returns to search).

AnalyticsTimeRangeSet

Update analytics time range filter.

Fields

since_ms: Option<i64>

until_ms: Option<i64>

AnalyticsAgentFilterSet(HashSet<String>)

Update analytics agent filter.

AnalyticsWorkspaceFilterSet(HashSet<String>)

Update analytics workspace filter.

AnalyticsSourceFilterSet(SourceFilter)

Update analytics source filter.

AnalyticsFiltersClearAll

Clear all analytics filters.

AnalyticsDrilldown(DrilldownContext)

Drilldown from analytics selection into the search view.

AnalyticsSelectionMoved

Move selection within the current analytics subview.

Fields

delta: i32

ExplorerMetricCycled

Cycle the Explorer metric forward or backward.

Fields

forward: bool

ExplorerOverlayCycled

Cycle the Explorer overlay mode.

ExplorerGroupByCycled

Cycle the Explorer group-by granularity forward or backward.

Fields

forward: bool

ExplorerZoomCycled

Cycle the Explorer zoom preset forward or backward.

Fields

forward: bool

BreakdownTabCycled

Cycle the Breakdowns tab forward or backward.

Fields

forward: bool

HeatmapMetricCycled

Cycle the Heatmap metric forward or backward.

Fields

forward: bool

SwarmEntered

Switch to the cached swarm operations cockpit surface.

SourcesEntered

Switch to the sources management surface.

SourcesRefreshed

Reload sources config + sync status from disk.

SourceSyncRequested(String)

Trigger sync for the selected source (by name).

SourceSyncCompleted

Sync completed with a structured result report.

Fields

report: SyncReport

SourceDoctorRequested(String)

Trigger doctor diagnostics for the selected source.

SourceDoctorCompleted

Doctor diagnostics completed.

Fields

source_name: String

passed: usize

warnings: usize

failed: usize

SourcesSelectionMoved

Move selection in the sources list.

Fields

delta: i32

ScreenshotRequested(ScreenshotFormat)

Capture a screenshot of the current TUI state.

ScreenshotCompleted(PathBuf)

Screenshot file was written successfully.

ScreenshotFailed(String)

Screenshot export failed.

MacroRecordingToggled

Toggle interactive macro recording (start/stop).

MacroRecordingSaved(PathBuf)

Macro recording saved to path.

MacroRecordingFailed(String)

Macro recording failed.

QuitRequested

Application quit requested.

ForceQuit

Force quit (Ctrl+C).

Trait Implementations

impl Debug for CassMsg

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl From<Event> for CassMsg

fn from(event: Event) -> Self

Converts to this type from the input type.