Enum AsyncMessage 

pub enum AsyncMessage {
    RemoteAttachReady(RemoteAttachReady),
    RemoteAttachFailed {
        error: String,
        request_id: u64,
    },
    LspDiagnostics {
        uri: String,
        diagnostics: Vec<Diagnostic>,
        server_name: String,
    },
    LspInitialized {
        language: String,
        server_name: String,
        capabilities: ServerCapabilitySummary,
    },
    LspError {
        language: String,
        error: String,
        stderr_log_path: Option<PathBuf>,
    },
    LspCompletion {
        request_id: u64,
        items: Vec<CompletionItem>,
    },
    LspGotoDefinition {
        request_id: u64,
        locations: Vec<Location>,
    },
    LspRename {
        request_id: u64,
        result: Result<WorkspaceEdit, String>,
    },
    LspHover {
        request_id: u64,
        contents: String,
        is_markdown: bool,
        range: Option<((u32, u32), (u32, u32))>,
    },
    LspReferences {
        request_id: u64,
        locations: Vec<Location>,
    },
    LspSignatureHelp {
        request_id: u64,
        signature_help: Option<SignatureHelp>,
    },
    LspCodeActions {
        request_id: u64,
        actions: Vec<CodeActionOrCommand>,
    },
    LspCompletionResolved {
        request_id: u64,
        item: Result<CompletionItem, String>,
    },
    LspFormatting {
        request_id: u64,
        uri: String,
        edits: Vec<TextEdit>,
    },
    LspPrepareRename {
        request_id: u64,
        result: Result<Value, String>,
    },
    LspPulledDiagnostics {
        request_id: u64,
        uri: String,
        result_id: Option<String>,
        diagnostics: Vec<Diagnostic>,
        unchanged: bool,
    },
    LspInlayHints {
        request_id: u64,
        uri: String,
        hints: Vec<InlayHint>,
    },
    LspFoldingRanges {
        request_id: u64,
        uri: String,
        ranges: Vec<FoldingRange>,
    },
    LspSemanticTokens {
        request_id: u64,
        uri: String,
        response: LspSemanticTokensResponse,
    },
    LspServerQuiescent {
        language: String,
    },
    LspDiagnosticRefresh {
        language: String,
    },
    LspInlayHintRefresh {
        language: String,
    },
    LspSemanticTokensRefresh {
        language: String,
    },
    LspDynamicCapabilities {
        language: String,
        server_name: String,
        register: bool,
        registrations: Vec<(String, Option<Value>)>,
    },
    FileChanged {
        path: String,
    },
    GitStatusChanged {
        status: String,
    },
    FileExplorerInitialized {
        window: WindowId,
        view: FileTreeView,
    },
    FileExplorerToggleNode(NodeId),
    FileExplorerRefreshNode(NodeId),
    FileExplorerExpandedToPath {
        window: WindowId,
        view: FileTreeView,
    },
    Plugin(PluginAsyncMessage),
    FileOpenDirectoryLoaded(Result<Vec<DirEntry>>),
    FileOpenShortcutsLoaded(Vec<NavigationShortcut>),
    TerminalOutput {
        terminal: WindowTerminalId,
    },
    ClipboardPasteResult {
        request_id: u64,
        text: Option<String>,
    },
    PathChanged {
        handle: u64,
        path: PathBuf,
        kind: PathChangeKind,
    },
    TerminalExited {
        terminal: WindowTerminalId,
        exit_code: Option<i32>,
    },
    LspProgress {
        language: String,
        token: String,
        value: LspProgressValue,
    },
    LspWindowMessage {
        language: String,
        message_type: LspMessageType,
        message: String,
    },
    LspLogMessage {
        language: String,
        message_type: LspMessageType,
        message: String,
    },
    LspApplyEdit {
        edit: WorkspaceEdit,
        label: Option<String>,
    },
    LspCodeActionResolved {
        request_id: u64,
        action: Result<CodeAction, String>,
    },
    LspServerRequest {
        language: String,
        server_command: String,
        method: String,
        params: Option<Value>,
    },
    PluginLspResponse {
        language: String,
        request_id: u64,
        result: Result<Value, String>,
    },
    PluginProcessOutput {
        process_id: u64,
        stdout: String,
        stderr: String,
        exit_code: i32,
    },
    LspStatusUpdate {
        language: String,
        server_name: String,
        status: LspServerStatus,
        message: Option<String>,
    },
    GrammarRegistryBuilt {
        registry: Arc<GrammarRegistry>,
        callback_ids: Vec<JsCallbackId>,
    },
    QuickOpenFilesLoaded {
        cwd: String,
        files: Arc<Vec<FileEntry>>,
        complete: bool,
    },
    PluginsDirLoaded {
        dir: PathBuf,
        errors: Vec<String>,
        discovered_plugins: HashMap<String, PluginConfig>,
    },
    PluginDeclarationsReady {
        declarations: Vec<(String, String)>,
    },
    PluginInitScriptLoaded(PluginInitScriptOutcome),
}

Messages sent from async tasks to the synchronous main loop

Variants

RemoteAttachReady(RemoteAttachReady)

An async attachRemoteAgent connect succeeded — install the authority + keepalive and restart.

RemoteAttachFailed

An async attachRemoteAgent connect failed — reject the plugin’s promise with error (the plugin shows it and creates no window); the editor stays on its current authority.

Fields

error: String

request_id: u64

LspDiagnostics

LSP diagnostics received for a file

Fields

uri: String

diagnostics: Vec<Diagnostic>

server_name: String

Name of the server that sent these diagnostics (for per-server tracking)

LspInitialized

LSP server initialized successfully

Fields

language: String

server_name: String

Name of the specific server (for per-server capability tracking)

capabilities: ServerCapabilitySummary

Capabilities reported by this server

LspError

LSP server crashed or failed

Fields

language: String

error: String

stderr_log_path: Option<PathBuf>

Path to the stderr log file for this LSP session

LspCompletion

LSP completion response

Fields

request_id: u64

items: Vec<CompletionItem>

LspGotoDefinition

LSP go-to-definition response

Fields

request_id: u64

locations: Vec<Location>

LspRename

LSP rename response

Fields

request_id: u64

result: Result<WorkspaceEdit, String>

LspHover

LSP hover response

Fields

request_id: u64

contents: String

Hover contents as a single string (joined if multiple parts)

is_markdown: bool

Whether the content is markdown (true) or plaintext (false)

range: Option<((u32, u32), (u32, u32))>

Optional range of the symbol that was hovered over (LSP line/character positions) Used to highlight the hovered symbol

LspReferences

LSP find references response

Fields

request_id: u64

locations: Vec<Location>

LspSignatureHelp

LSP signature help response

Fields

request_id: u64

signature_help: Option<SignatureHelp>

LspCodeActions

LSP code actions response

Fields

request_id: u64

actions: Vec<CodeActionOrCommand>

LspCompletionResolved

LSP completionItem/resolve response

Fields

request_id: u64

item: Result<CompletionItem, String>

LspFormatting

LSP textDocument/formatting response

Fields

request_id: u64

uri: String

edits: Vec<TextEdit>

LspPrepareRename

LSP textDocument/prepareRename response

Fields

request_id: u64

result: Result<Value, String>

LspPulledDiagnostics

LSP pulled diagnostics response (textDocument/diagnostic)

Fields

request_id: u64

uri: String

result_id: Option<String>

New result_id for incremental updates (None if server doesn’t support)

diagnostics: Vec<Diagnostic>

Diagnostics (empty if unchanged)

unchanged: bool

True if diagnostics haven’t changed since previous_result_id

LspInlayHints

LSP inlay hints response (textDocument/inlayHint)

Fields

request_id: u64

uri: String

hints: Vec<InlayHint>

Inlay hints for the requested range

LspFoldingRanges

LSP folding ranges response (textDocument/foldingRange)

Fields

request_id: u64

uri: String

ranges: Vec<FoldingRange>

LspSemanticTokens

LSP semantic tokens response (full, full/delta, or range)

Fields

request_id: u64

uri: String

response: LspSemanticTokensResponse

LspServerQuiescent

LSP server status became quiescent (project fully loaded) This is a rust-analyzer specific notification (experimental/serverStatus)

Fields

language: String

LspDiagnosticRefresh

LSP server requests diagnostic refresh (workspace/diagnostic/refresh) Client should re-pull diagnostics for all open documents

Fields

language: String

LspInlayHintRefresh

LSP server requests an inlay-hint refresh (workspace/inlayHint/refresh). Client should re-pull inlay hints for all open documents — used when the server learns more later (e.g. a change in file A alters inferred types in file B, which the user never edited so was never otherwise re-pulled).

Fields

language: String

LspSemanticTokensRefresh

LSP server requests a semantic-tokens refresh (workspace/semanticTokens/refresh). Client should re-pull semantic tokens for all open documents.

Fields

language: String

LspDynamicCapabilities

LSP server registered (client/registerCapability) or unregistered (client/unregisterCapability) one or more capabilities dynamically. Many servers advertise little or nothing statically in their initialize result and instead register providers afterwards, so these must update the stored ServerCapabilities or the features stay gated off for the whole session. register == false means unregister. Each entry is (method, register_options).

Fields

language: String

server_name: String

register: bool

registrations: Vec<(String, Option<Value>)>

FileChanged

File changed externally (future: file watching)

Fields

path: String

GitStatusChanged

Git status updated (future: git integration)

Fields

status: String

FileExplorerInitialized

File explorer initialized with tree view. Carries the id of the window that requested it: a background preview/materialize can init a non-active window’s explorer, so the view must land on that window — applying it to whatever is active would clobber an unrelated explorer.

Fields

window: WindowId

view: FileTreeView

FileExplorerToggleNode(NodeId)

File explorer node toggle completed

FileExplorerRefreshNode(NodeId)

File explorer node refresh completed

FileExplorerExpandedToPath

File explorer expand to path completed. Carries the requesting window id (see FileExplorerInitialized) so the expanded view returns to its own window rather than the active one.

Fields

window: WindowId

view: FileTreeView

Plugin(PluginAsyncMessage)

Plugin-related async messages

FileOpenDirectoryLoaded(Result<Vec<DirEntry>>)

File open dialog: directory listing completed

FileOpenShortcutsLoaded(Vec<NavigationShortcut>)

File open dialog: async shortcuts (Windows drive letters) loaded

TerminalOutput

Terminal output received (triggers redraw). Tagged with the owning window: terminal ids are only unique within a window, so a bare id can’t be attributed to a session without guessing.

Fields

terminal: WindowTerminalId

ClipboardPasteResult

Result of an asynchronous system-clipboard read. The main loop blocks input dispatch while a paste is in flight; the matching request_id ensures a late result that arrived after the timeout fallback fired is discarded as stale. text is None when the read errored, returned empty, or was cancelled by the deadline.

Fields

request_id: u64

text: Option<String>

PathChanged

File watcher delivered an event for a path under a WatchPath-registered watcher. Routed to the path_changed plugin hook by the main loop.

Fields

handle: u64

Watch handle the event came from (matches the value returned by WatchPath).

path: PathBuf

kind: PathChangeKind

Conservative bucketing of notify::EventKind.

TerminalExited

Terminal process exited.

exit_code is None when the editor cannot determine a status (the wait happens in a separate thread, signal exits, kill before wait, etc.). Populated end-to-end is a follow-up; the initial wiring sends None so plugin handlers see the variant shape that matches HookArgs::TerminalExited.

Fields

terminal: WindowTerminalId

exit_code: Option<i32>

LspProgress

LSP progress notification ($/progress)

Fields

language: String

token: String

value: LspProgressValue

LspWindowMessage

LSP window message (window/showMessage)

Fields

language: String

message_type: LspMessageType

message: String

LspLogMessage

LSP log message (window/logMessage)

Fields

language: String

message_type: LspMessageType

message: String

LspApplyEdit

LSP workspace/applyEdit (server -> client request) Server asks client to apply a workspace edit (during executeCommand, etc.)

Fields

edit: WorkspaceEdit

label: Option<String>

LspCodeActionResolved

LSP codeAction/resolve response

Fields

request_id: u64

action: Result<CodeAction, String>

LspServerRequest

LSP server request (server -> client) Used for custom/extension methods that plugins can handle

Fields

language: String

server_command: String

method: String

params: Option<Value>

PluginLspResponse

Response for a plugin-initiated LSP request

Fields

language: String

request_id: u64

result: Result<Value, String>

PluginProcessOutput

Plugin process completed with output

Fields

process_id: u64

Unique ID for this process (to match with callback)

stdout: String

Standard output

stderr: String

Standard error

exit_code: i32

Exit code

LspStatusUpdate

LSP server status update (progress, messages, etc.)

Fields

language: String

server_name: String

Name of the specific server (for multi-server status tracking)

status: LspServerStatus

message: Option<String>

GrammarRegistryBuilt

Background grammar build completed — swap in the new registry. callback_ids contains plugin callbacks to resolve (empty for the initial startup build).

Fields

registry: Arc<GrammarRegistry>

callback_ids: Vec<JsCallbackId>

QuickOpenFilesLoaded

Quick Open file list loaded by a background task. complete is true when the scan is finished, false for incremental partial updates sent while the walk is still in progress.

Fields

cwd: String

The working directory the files were enumerated under. Lets the editor drop results that arrive after the user has switched windows/projects (the cache is keyed by cwd).

files: Arc<Vec<FileEntry>>

complete: bool

PluginsDirLoaded

Startup-async: a single plugin directory finished loading on the plugin thread. Carries the same payload as the blocking load_plugins_from_dir_with_config return value.

Fields

dir: PathBuf

errors: Vec<String>

discovered_plugins: HashMap<String, PluginConfig>

PluginDeclarationsReady

Startup-async: every directory in the startup batch has loaded and the resulting .d.ts declarations have been collected from the plugin runtime. Triggers init_script::write_plugin_declarations.

Fields

declarations: Vec<(String, String)>

PluginInitScriptLoaded(PluginInitScriptOutcome)

Startup-async: init.ts (auto-loaded source plugin) finished running its top level and has either succeeded, failed, or was skipped/fused. The handler logs and applies the corresponding status message, and (on Loaded) clears the crash fuse.

Trait Implementations

impl Debug for AsyncMessage

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

Formats the value using the given formatter.