Documentation
¶
Overview ¶
Package messages defines the shared Bubble Tea message vocabulary exchanged between the app message pump and the UI panes: user intents, lifecycle events, and cross-pane notifications. See internal/app/MESSAGE_FLOW.md.
Index ¶
- type AddProject
- type CleanupTmuxSessions
- type CloseTab
- type CreateAgentTab
- type CreateWorkspace
- type DeleteWorkspace
- type Error
- type FileWatcherEvent
- type FocusPane
- type GitStatusRequest
- type GitStatusResult
- type GitStatusTick
- type LaunchAgent
- type OpenDiff
- type OpenFileInVim
- type OrphanGCTick
- type PTYWatchdogTick
- type PaneType
- type ProjectAdded
- type ProjectRemoved
- type ProjectsLoaded
- type RefreshDashboard
- type RemoveProject
- type RenameWorkspace
- type RescanWorkspaces
- type RunScript
- type ScriptOutput
- type ShowAddProjectDialog
- type ShowCleanupTmuxDialog
- type ShowCommandsPalette
- type ShowCommitWorkspaceDialog
- type ShowCreateWorkspaceDialog
- type ShowDeleteWorkspaceDialog
- type ShowQuitDialog
- type ShowRemoveProjectDialog
- type ShowRenameWorkspaceDialog
- type ShowSelectAssistantDialog
- type ShowSettingsDialog
- type ShowTrustScriptsDialog
- type ShowWelcome
- type ShowWorkspaceEnvDialog
- type SidebarPTYFlush
- type SidebarPTYOutput
- type SidebarPTYRestart
- type SidebarPTYStopped
- type StateWatcherEvent
- type SwitchTab
- type TabClosed
- type TabCreated
- type TabDetached
- type TabReattached
- type TabSelectionChanged
- type TabSessionStatus
- type TabStateChanged
- type TmuxSyncTick
- type Toast
- type ToastLevel
- type ToggleKeymapHints
- type TriggerUpgrade
- type UpdateCheckComplete
- type UpgradeComplete
- type WorkspaceActivated
- type WorkspaceCommitted
- type WorkspaceCreateFailed
- type WorkspaceCreated
- type WorkspaceCreatedWithWarning
- type WorkspaceDeleteFailed
- type WorkspaceDeleted
- type WorkspaceSetupComplete
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type CleanupTmuxSessions ¶ added in v0.0.9
type CleanupTmuxSessions struct{}
CleanupTmuxSessions requests cleanup of amux tmux sessions.
type CreateAgentTab ¶
CreateAgentTab requests creation of a new agent tab
type CreateWorkspace ¶ added in v0.0.5
CreateWorkspace requests creating a new workspace
type DeleteWorkspace ¶ added in v0.0.5
DeleteWorkspace requests deleting a workspace
type FileWatcherEvent ¶
type FileWatcherEvent struct {
Root string
}
FileWatcherEvent is sent when a watched file changes
type FocusPane ¶
type FocusPane struct {
Pane PaneType
}
FocusPane requests focus change to a specific pane
type GitStatusRequest ¶
type GitStatusRequest struct {
Root string
}
GitStatusRequest requests a git status refresh
type GitStatusResult ¶
type GitStatusResult struct {
Root string
Status *git.StatusResult
Err error
}
GitStatusResult contains the result of a git status command
type LaunchAgent ¶
LaunchAgent requests launching an agent in a new tab
type OpenFileInVim ¶ added in v0.0.4
OpenFileInVim requests opening a file in vim in the center pane
type OrphanGCTick ¶ added in v0.0.15
type OrphanGCTick struct{}
OrphanGCTick triggers periodic tmux orphan session cleanup.
type PTYWatchdogTick ¶ added in v0.0.5
type PTYWatchdogTick struct{}
PTYWatchdogTick triggers a periodic check for stalled PTY readers.
type ProjectAdded ¶
ProjectAdded is sent when a new project is registered
type ProjectRemoved ¶
type ProjectRemoved struct {
Path string
}
ProjectRemoved is sent when a project is unregistered
type ProjectsLoaded ¶
type ProjectsLoaded struct {
Projects []data.Project
// LoadToken identifies the load generation; handleProjectsLoaded drops a
// result older than the last applied one so out-of-order reloads (e.g. under
// rapid deletes) cannot resurrect a just-deleted workspace. Zero applies
// unconditionally (back-compat).
LoadToken int
}
ProjectsLoaded is sent when projects have been loaded/reloaded
type RefreshDashboard ¶
type RefreshDashboard struct{}
RefreshDashboard requests a dashboard refresh
type RemoveProject ¶
RemoveProject requests removing a project from the registry
type RenameWorkspace ¶ added in v0.0.20
RenameWorkspace requests renaming a workspace's display label (Tier-1). Only the human Name changes; the git branch, worktree, and workspace ID are left untouched.
type RescanWorkspaces ¶ added in v0.0.8
type RescanWorkspaces struct{}
RescanWorkspaces requests a git worktree rescan/import.
type RunScript ¶
type RunScript struct {
ScriptType string // "setup", "run", or "archive"
}
RunScript requests running a script for the active workspace
type ScriptOutput ¶
ScriptOutput contains output from a running script
type ShowAddProjectDialog ¶
type ShowAddProjectDialog struct{}
ShowAddProjectDialog requests showing the add project dialog
type ShowCleanupTmuxDialog ¶ added in v0.0.9
type ShowCleanupTmuxDialog struct{}
ShowCleanupTmuxDialog requests confirmation before cleaning tmux sessions.
type ShowCommandsPalette ¶ added in v0.0.16
type ShowCommandsPalette struct{}
ShowCommandsPalette requests opening the bottom command palette.
type ShowCommitWorkspaceDialog ¶ added in v0.0.20
ShowCommitWorkspaceDialog requests showing the commit-message input dialog for a workspace's changes (git commit-all).
type ShowCreateWorkspaceDialog ¶ added in v0.0.5
ShowCreateWorkspaceDialog requests showing the create workspace dialog
type ShowDeleteWorkspaceDialog ¶ added in v0.0.5
ShowDeleteWorkspaceDialog requests showing the delete workspace confirmation
type ShowQuitDialog ¶
type ShowQuitDialog struct{}
ShowQuitDialog requests showing the quit confirmation dialog
type ShowRemoveProjectDialog ¶
ShowRemoveProjectDialog requests showing the remove project confirmation
type ShowRenameWorkspaceDialog ¶ added in v0.0.20
ShowRenameWorkspaceDialog requests showing the rename workspace input dialog
type ShowSelectAssistantDialog ¶
type ShowSelectAssistantDialog struct{}
ShowSelectAssistantDialog requests showing the assistant selection dialog
type ShowSettingsDialog ¶
type ShowSettingsDialog struct{}
ShowSettingsDialog requests showing the settings dialog
type ShowTrustScriptsDialog ¶ added in v0.0.20
ShowTrustScriptsDialog requests confirmation before trusting repo scripts.
type ShowWorkspaceEnvDialog ¶ added in v0.0.20
ShowWorkspaceEnvDialog requests showing the workspace environment-variable editor for the given workspace.
type SidebarPTYFlush ¶
SidebarPTYFlush applies buffered PTY output for sidebar terminal
type SidebarPTYOutput ¶
SidebarPTYOutput contains PTY output for sidebar terminal
type SidebarPTYRestart ¶ added in v0.0.5
SidebarPTYRestart requests restarting a sidebar PTY reader.
type SidebarPTYStopped ¶
SidebarPTYStopped signals that the sidebar PTY read loop has stopped
type StateWatcherEvent ¶ added in v0.0.11
StateWatcherEvent is sent when amux state files change on disk.
type TabCreated ¶
TabCreated is sent when a new tab is created
type TabDetached ¶ added in v0.0.9
TabDetached is sent when a tab is detached (tmux session remains).
type TabReattached ¶ added in v0.0.9
TabReattached is sent when a detached tab is reattached.
type TabSelectionChanged ¶ added in v0.0.9
TabSelectionChanged indicates the active tab changed for a workspace.
type TabSessionStatus ¶ added in v0.0.9
TabSessionStatus reports a tmux session status change for a tab.
type TabStateChanged ¶ added in v0.0.9
TabStateChanged indicates a tab state change that should be persisted.
type TmuxSyncTick ¶ added in v0.0.9
type TmuxSyncTick struct {
Token int
}
TmuxSyncTick triggers a periodic tmux session sync for the active workspace.
type Toast ¶ added in v0.0.9
type Toast struct {
Message string
Level ToastLevel
}
Toast requests a toast notification in the UI.
type ToastLevel ¶ added in v0.0.9
type ToastLevel string
ToastLevel identifies the type of toast notification to display.
const ( ToastInfo ToastLevel = "info" ToastSuccess ToastLevel = "success" ToastError ToastLevel = "error" ToastWarning ToastLevel = "warning" )
type ToggleKeymapHints ¶
type ToggleKeymapHints struct{}
ToggleKeymapHints toggles display of keymap helper text
type TriggerUpgrade ¶ added in v0.0.3
type TriggerUpgrade struct{}
TriggerUpgrade is sent when the user requests an upgrade
type UpdateCheckComplete ¶ added in v0.0.3
type UpdateCheckComplete struct {
CurrentVersion string
LatestVersion string
UpdateAvailable bool
ReleaseNotes string
Err error
}
UpdateCheckComplete is sent when the background update check finishes
type UpgradeComplete ¶ added in v0.0.3
UpgradeComplete is sent when the upgrade finishes
type WorkspaceActivated ¶ added in v0.0.5
WorkspaceActivated is sent when a workspace is selected
type WorkspaceCommitted ¶ added in v0.0.20
WorkspaceCommitted is sent when a commit-all attempt finishes. Err is non-nil on failure (surfaced via ReportError); on success the sidebar diff/status view is refreshed for the workspace.
type WorkspaceCreateFailed ¶ added in v0.0.5
WorkspaceCreateFailed is sent when a workspace creation fails
type WorkspaceCreated ¶ added in v0.0.5
WorkspaceCreated is sent when a new workspace is created
type WorkspaceCreatedWithWarning ¶ added in v0.0.5
WorkspaceCreatedWithWarning indicates workspace was created but setup had issues
type WorkspaceDeleteFailed ¶ added in v0.0.5
WorkspaceDeleteFailed is sent when a workspace deletion fails
type WorkspaceDeleted ¶ added in v0.0.5
type WorkspaceDeleted struct {
Project *data.Project
Workspace *data.Workspace
Err error
// Warning is a non-fatal note (e.g. the branch could not be deleted). The
// workspace delete still succeeded; this is surfaced to the user as a toast.
Warning string
}
WorkspaceDeleted is sent when a workspace is deleted
type WorkspaceSetupComplete ¶ added in v0.0.5
WorkspaceSetupComplete is sent when async setup scripts finish