Enum RpcCommand 

pub enum RpcCommand {
    Prompt {
        id: Option<String>,
        prompt: String,
        backend: Option<String>,
        max_iterations: Option<u32>,
    },
    Guidance {
        id: Option<String>,
        message: String,
    },
    Steer {
        id: Option<String>,
        message: String,
    },
    FollowUp {
        id: Option<String>,
        message: String,
    },
    Abort {
        id: Option<String>,
        reason: Option<String>,
    },
    GetState {
        id: Option<String>,
    },
    GetIterations {
        id: Option<String>,
        include_content: bool,
    },
    SetHat {
        id: Option<String>,
        hat: String,
    },
    ExtensionUiResponse {
        id: Option<String>,
        request_id: String,
        response: Value,
    },
}

Commands sent to Ralph via stdin.

Each command is a single JSON line. Commands with an id field receive correlated responses.

Variants

Prompt

Start the loop with a prompt (must be sent before loop starts).

Fields

id: Option<String>

prompt: String

The prompt text to execute.

backend: Option<String>

Optional backend override.

max_iterations: Option<u32>

Optional max iterations override.

Guidance

Inject guidance that affects the current or next iteration. Equivalent to the TUI’s guidance input.

Fields

id: Option<String>

message: String

The guidance message to inject.

Steer

Steer the agent immediately during the current iteration. The guidance is injected into the running context.

Fields

id: Option<String>

message: String

The steering message.

FollowUp

Queue a follow-up message for the next iteration.

Fields

id: Option<String>

message: String

The follow-up message.

Abort

Request immediate termination of the loop.

Fields

id: Option<String>

reason: Option<String>

Optional reason for the abort.

GetState

Request the current loop state snapshot.

Fields

id: Option<String>

GetIterations

Request iteration history and metadata.

Fields

id: Option<String>

include_content: bool

If true, include full iteration content. Default: false (metadata only).

SetHat

Force a hat change for the next iteration.

Fields

id: Option<String>

hat: String

The hat ID to switch to.

ExtensionUiResponse

Response to an extension UI prompt (future support).

Fields

id: Option<String>

request_id: String

The extension request ID being responded to.

response: Value

The user’s response data.

Implementations

impl RpcCommand

pub fn id(&self) -> Option<&str>

Returns the command’s correlation ID if present.

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

Returns the command type name (for response correlation).

Trait Implementations

impl Clone for RpcCommand

fn clone(&self) -> RpcCommand

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RpcCommand

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for RpcCommand

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for RpcCommand

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for RpcCommand

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 RpcCommand