Enum Block 

#[non_exhaustive]
pub enum Block {
    Text(String),
    FileRef {
        path: String,
        hash: Option<String>,
        excerpt: Option<String>,
    },
    Skill {
        name: String,
        body: String,
    },
    ToolCall {
        call_id: String,
        name: String,
        args: Value,
    },
    ToolResult {
        call_id: String,
        content: Value,
    },
    Feedback(Vec<Signal>),
    Reasoning(String),
}

A single block of content within the assembled prompt.

Blocks are grouped so that long-stable prefixes (system + guides) stay cacheable across turns (“prompt caching” pattern).

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Text(String)

Plain prompt text.

FileRef

Reference to a file in the world. The runtime decides whether to inline contents or hand the agent a tool call to read it.

Fields

path: String

hash: Option<String>

excerpt: Option<String>

Skill

Reference to an activated SKILL.md body.

Fields

name: String

body: String

ToolCall

A tool call the assistant requested.

Fields

call_id: String

name: String

args: Value

ToolResult

The result of a previous tool call.

Fields

call_id: String

content: Value

Feedback(Vec<Signal>)

Feedback signals from sensors, rendered for the model.

Reasoning(String)

Provider-specific reasoning trace (DeepSeek reasoning_content, Anthropic thinking blocks). Must be echoed back to the provider on subsequent calls or the API rejects the request.

Trait Implementations

impl Clone for Block

fn clone(&self) -> Block

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Block

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Block

fn deserialize<__D>( __deserializer: __D, ) -> Result<Block, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Block

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

where __S: Serializer,

Serialize this value into the given Serde serializer.