Enum ControllerAction 

pub enum ControllerAction {
    New {
        workspace_id: String,
        profile_id: String,
        bundle_id: String,
        target_id: String,
        title: Option<String>,
        project_directory: Option<PathBuf>,
        dirty_ack: Vec<String>,
    },
    Rename {
        session_id: String,
        title: String,
    },
    CancelTurn {
        session_id: String,
    },
    SetConfig {
        session_id: String,
        key: String,
        value: String,
    },
    SetPlanMode {
        session_id: String,
        active: bool,
    },
    RefreshQuota {
        profile_id: String,
    },
    RefreshCapacity {
        target_id: String,
    },
    Resume {
        session_id: String,
        workspace_id: String,
        profile_id: String,
        target_id: String,
        queue: ResumeQueueDisposition,
        additional_mounts: Option<Vec<AdditionalMount>>,
        resource_allocation: Option<SessionResourceAllocation>,
    },
    Move {
        request: MoveSessionRequest,
    },
    Open {
        session_id: String,
    },
    Prompt {
        session_id: String,
        text: String,
        images: Vec<ViewerPromptImage>,
    },
    RunShell {
        session_id: String,
        command: String,
    },
    CancelShell {
        session_id: String,
        shell_command_id: String,
    },
    Close {
        session_id: String,
    },
    Cancel {
        session_id: String,
    },
    StartReview {
        session_id: String,
    },
    ResolveReview {
        session_id: String,
        resolution: String,
    },
    RemoveQueuedPrompt {
        session_id: String,
        queue_id: String,
    },
    RespondElicitation {
        session_id: String,
        elicitation_id: String,
        response: ElicitationResponse,
    },
}

The complete set of operations a phone may ask the controller to perform. Destructive force-cleanup and secret/config editing are intentionally not representable here.

Variants

New

Fields

workspace_id: String

Which workspace the session belongs to. Optional on the wire so a viewer cached from before workspaces reached the phone still parses, but a controller holding more than one workspace refuses an empty one rather than guessing.

profile_id: String

bundle_id: String

target_id: String

title: Option<String>

Absent means “derive it”, which is what the terminal does.

project_directory: Option<PathBuf>

dirty_ack: Vec<String>

The repositories the person was shown as having uncommitted changes and chose to launch over anyway.

This names them rather than being a bare yes, so an acknowledgement cannot be replayed against a set the person never saw: if a different repository has gone dirty since the preflight, the launch stops and asks again.

Rename

Give a session a new title. The terminal calls this a rename.

Fields

session_id: String

title: String

CancelTurn

Stop the turn the agent is working on, leaving the session alive. This is not Cancel, which stops a provision, resume or stop.

Fields

session_id: String

SetConfig

Change one setting the harness advertised, such as model or effort.

Fields

session_id: String

key: String

value: String

SetPlanMode

Turn plan mode on or off. The harness decides how, which is why this carries an intent rather than a mode id.

Fields

session_id: String

active: bool

RefreshQuota

Fields

profile_id: String

RefreshCapacity

Fields

target_id: String

Resume

Fields

session_id: String

workspace_id: String

profile_id: String

target_id: String

queue: ResumeQueueDisposition

additional_mounts: Option<Vec<AdditionalMount>>

A failed Move supplies the settings recorded before source teardown. Ordinary Resume requests leave these absent and retain the historical inheritance behavior.

resource_allocation: Option<SessionResourceAllocation>

Move

Confirm a previously prepared move. Preparation is a separate authenticated request so changing the destination cannot be smuggled into a confirmation from an older browser form.

Fields

request: MoveSessionRequest

Open

Fields

session_id: String

Prompt

Fields

session_id: String

text: String

images: Vec<ViewerPromptImage>

Images to send with the prompt. The controller turns each one into the ACP image content block its prompt path already speaks.

RunShell

Fields

session_id: String

command: String

CancelShell

Fields

session_id: String

shell_command_id: String

Close

Fields

session_id: String

Cancel

Fields

session_id: String

StartReview

Review the turn this session just finished.

Fields

session_id: String

ResolveReview

Forward the findings, dismiss them, or cancel the open review.

Fields

session_id: String

resolution: String

forward, dismiss, or cancel.

RemoveQueuedPrompt

Fields

session_id: String

queue_id: String

RespondElicitation

Answer one of the session’s pending form questions.

Fields

session_id: String

elicitation_id: String

response: ElicitationResponse

Trait Implementations

impl Clone for ControllerAction

fn clone(&self) -> ControllerAction

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ControllerAction

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ControllerAction

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for ControllerAction

fn eq(&self, other: &ControllerAction) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for ControllerAction

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ControllerAction