Struct AiConversationMode 

pub struct AiConversationMode { /* private fields */ }

ai-conversation-mode – major mode for the *ai:opencode* buffer.

Holds the prompt’s editable-region anchor: the absolute line where the prompt begins (== the transcript line count). The drain updates it on each re-projection; editable_tail publishes it so the read-only gate lets the user edit a multi-line prompt (<C-j> inserts a newline) while the transcript above stays frozen. One instance backs the single (v1) conversation buffer, so one shared anchor suffices.

AUX‑2: headerline_version is bumped by the drain on each re-projection so the ConversationHeaderline widget republishes its row when usage changes.

Implementations

impl AiConversationMode

pub fn new() -> Self

pub fn mode_id() -> ModeId

Trait Implementations

impl Clone for AiConversationMode

fn clone(&self) -> AiConversationMode

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Default for AiConversationMode

fn default() -> Self

Returns the “default value” for a type.

impl Mode for AiConversationMode

fn invocation_runner(&self) -> Option<ModeId>

AU‑3 gap fix: claim the invocation runner so vim operators respect the editable tail. The host registers Editor::run_editable_tail_invocation under this mode id (editor_boot.rs); it gates mutating operators (x / dd / dw) started in the frozen transcript and lets them through in the prompt. Without a runner, operators fell through to the ungated document path and mutated the read-only transcript.

fn implies(&self) -> &[ModeId]

Pull in repl-mode on the conversation buffer: it owns the generic insert-entry surface (i/a/o/… → jump-to-prompt-and-Insert). The activation cascade turns it on wherever this major is active and off when the buffer’s major changes, so the affordance is scoped to the REPL buffer without a bespoke keymap on this mode.

fn editable_tail(&self) -> Option<EditableTail>

AU‑3: the prompt is the single trailing line, editable only after the "> " marker (2 bytes). Consulted by the host’s read-only edit gate so Insert/operator keystrokes land only in the prompt; the transcript above stays owner-written.

fn keymap(&self) -> Keymap

AU‑3: the modal-input surface. Insert-entering chords relocate the cursor into the prompt first (so Insert only ever edits the prompt, and history is unreachable from Insert); <CR> sends; <C-c> interrupts. The host’s K.2.4 translate pass pushes these under MajorMode(ai-conversation-mode), gated by K.1.c to this buffer.

fn action_handlers(&self) -> Vec<ActionHandlerContribution>

AU‑3: the handler bodies for the chords above, mode-owned (no host Editor:: method, no Action variant). Bound at boot by the host’s register_mode_action_handlers walk. Each reads the buffer / services from the [ActionContext] and returns an [Effect] the host applies.

type Guard = Option<AiConversationGuard>

Owned cleanup token returned by [Self::on_activate].

fn id(&self) -> ModeId

Canonical identity. Same value every call.

fn kind(&self) -> ModeKind

Major or minor. Read at registration and on every activation call (activate_major on a minor, or vice versa, is [ModeActivationError::WrongKind]).

fn options(&self) -> OptionOverrideSet

Option overrides this mode contributes. Pure declarative (same return value every call); the host merges these into the buffer’s option-resolution layer stack while the mode is active, at the mode’s layer (later-activated minors win ties), and drops them on deactivation. Build with lattice_config::overrides! { lattice_config::Wrap = true, … }.

fn required_capabilities(&self) -> CapabilitySet

Capabilities the mode requires. Validated at activation; missing capability ⇒ [ModeActivationError::MissingCapability], never silent skip.

fn on_activate(&self, ctx: ModeContext) -> LifecycleFuture<'_, Self::Guard>

Lifecycle. Called once per (buffer, activation) cycle after the registry has applied the declarative contributions. Returns an owned Guard carrying every resource the mode allocated. The dispatcher stashes the Guard until deactivation, at which point dropping it performs cleanup via the Guard’s Drop impl.

fn target_buffer_kind(&self) -> Option<BufferKind>

For major modes, the [BufferKind] this mode is the default major for (H.2, 2026-05-31). ModeRegistry::register indexes this so ModeRegistry::find_major_for_kind can dispatch buffer-creation events to the right major without host-side match BufferKind { ... } blocks.

fn target_language(&self) -> Option<&str>

For major modes, the language this mode is the default major for, by canonical name (Lang::name() — "rust", "org") (OM.1). The peer of target_buffer_kind for the dispatch path [BufferKind::Document] takes: language detection rather than kind dispatch.

fn decorations(&self) -> Vec<DecorationProvider>

Decoration providers (gutter / inline / overlay / statusline). Stub — reserved for the WIT plugin path (M.10).

fn gutter_decorations(&self, _ctx: &DecorationCtx<'_>) -> Vec<GutterDecoration>

Gutter sign decorations this mode contributes while active. Called once per pane per frame with a [DecorationCtx] carrying relevant render-state snapshots (diff sign map, LSP diagnostics arc). Returns per-line GutterDecoration values; the renderer partitions them by variant into the appropriate gutter column. Default: empty (no contribution).

fn completion_sources(&self) -> Vec<CompletionSourceContribution>

Insert-mode completion sources this mode contributes while active on a buffer. Empty by default; minors that own a completion source (lsp-completion-mode, snippet-completion-mode, buffer-words-mode, tree-sitter-completion-mode, path-completion-mode, plugin sources) override.

fn conflicts_with(&self) -> &[ModeId]

Modes this one cannot be active alongside.

fn presents_extensions(&self) -> &[&'static str]

File extensions (lowercase, no dot) this major PRESENTS rather than edits — the file is never loaded as text.

fn mirrors_option(&self) -> Option<&'static str>

Declarative mirror hint for “this mode is the on/off switch for a typed option of the same observable state”. Some(canonical_name) ⇒ a host-driven cascade keeps the mode’s active state and the option’s value in sync.

fn refresh_action(&self) -> Option<&'static str>

Which of this mode’s own actions refreshes its view, or None (the default) when the mode backs nothing refreshable (RV.1, 2026-08-10).

fn fold_toggle_action(&self) -> Option<&'static str>

Which of this mode’s actions <Tab> fires, and the declaration that pulls in foldable-view-mode — the shared minor owning the chord.

fn refresh_on_open(&self) -> bool

Should re-opening this view re-run its refresh?

fn activation_policy(&self) -> ActivationPolicy

A minor mode’s default auto-activation policy (MA.1; mode-architecture.md §7.4). The host’s minor-activation resolver reads this for every registered minor when a buffer enters a major mode, and activates those whose policy admits the entered major. The default is [ActivationPolicy::Manual] — auto-activate nowhere until the mode or the user opts in. Ignored for major modes (a buffer’s major is chosen by the major resolver, not this allowlist).