Enum Op 

pub enum Op {
    SendMessage {
        content: String,
        mode: String,
        model: Option<String>,
        model_provider: Option<String>,
        allowed_tools: Option<Vec<String>>,
        dynamic_tools: Vec<Value>,
        provenance: String,
    },
    Steer {
        content: String,
    },
    ContinueGoal,
    RunShellCommand {
        command: String,
    },
    SetGoalStatus {
        status: String,
        clear: bool,
    },
    Cancel,
    Shutdown,
    PreviewOutboundRequest {
        json: bool,
        base_prompt_only: bool,
    },
}

Operations that can be submitted to the core engine. This is the protocol view of crates/tui/src/core/ops::Op — same lifecycle, same provenance gate — but serializable and free of mpsc / oneshot fields. In-process callers convert at the boundary; out-of-process callers send the JSON directly.

Variants

SendMessage

Drive one model turn: role=user content plus the resolved route receipt the engine will freeze at the client-freeze boundary. Headless and TUI must produce byte-identical MessageRequests for identical Op::SendMessage payloads.

Fields

content: String

mode: String

Effective mode for this turn ("plan" | "agent" | "operate" etc).

model: Option<String>

Optional explicit route/model the caller resolved already (mirrors ResolvedRuntimeRoute in crates_tui::route_runtime). None means “use the thread’s current route”.

model_provider: Option<String>

allowed_tools: Option<Vec<String>>

Tool restriction from slash-command frontmatter.

dynamic_tools: Vec<Value>

Runtime-supplied dynamic tools for this turn only.

provenance: String

Structural input provenance — only ExternalUser may inherit YOLO/auto-approval authority (mirrors UserInputProvenance).

Steer

Steer an in-flight turn with additional user content (drains into the turn loop’s rx_steer channel).

Fields

content: String

ContinueGoal

Re-check and dispatch a goal continuation (synthetic turn that continues the same logical goal run).

RunShellCommand

Execute a local composer shell command without a model turn.

Fields

command: String

SetGoalStatus

Set goal status without dispatching a model turn.

Fields

status: String

clear: bool

Cancel

Shutdown

PreviewOutboundRequest

Describe the exact request the next turn would send without sending it (/dryrun / /preview-request, #1004). Headless and TUI must render identical manifests for identical inputs.

Fields

json: bool

base_prompt_only: bool

Implementations

impl Op

pub fn is_send_message(&self) -> bool

pub fn kind_str(&self) -> &'static str

Trait Implementations

impl Clone for Op

fn clone(&self) -> Op

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Op

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Op

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Op

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.