Struct TurnPrompt 

pub struct TurnPrompt {
    pub attachments: Vec<TurnPromptAttachment>,
    pub text: String,
    pub text_source: TurnPromptTextSource,
}

Structured prompt payload for one agent turn.

Fields

attachments: Vec<TurnPromptAttachment>

Ordered local image attachments referenced by text.

text: String

Prompt text payload, including inline placeholders when present.

text_source: TurnPromptTextSource

Source classification that controls prompt-only text rewrites.

Implementations

impl TurnPrompt

pub fn from_text(text: String) -> TurnPrompt

Creates a text-only prompt payload.

pub fn from_agent_data(text: String) -> TurnPrompt

Creates a generated-data prompt payload that is sent to the agent without user prompt @path lookup rewriting.

pub fn is_empty(&self) -> bool

Returns whether the payload contains no text and no attachments.

pub fn has_attachments(&self) -> bool

Returns whether the payload contains one or more image attachments.

pub fn local_image_paths(&self) -> impl Iterator<Item = &PathBuf>

Returns the local image paths referenced by this prompt payload.

pub fn contains(&self, needle: &str) -> bool

Returns whether the prompt text contains needle.

pub fn ends_with(&self, suffix: &str) -> bool

Returns whether the prompt text ends with suffix.

pub fn agent_text(&self) -> String

Returns the prompt text as it should be sent to an agent runtime.

User-authored @path lookups are rewritten to quoted path tokens for transport. Generated agent data is returned unchanged so source content such as Python decorators keeps its leading @.

pub fn content_parts(&self) -> Vec<TurnPromptContentPart<'_>>

Returns prompt text spans and image attachments in transport order.

Attachments are ordered by their placeholder position in text. Any attachment whose placeholder no longer exists in the text is appended after the trailing text so transports can still serialize the image instead of dropping it silently.

pub fn transcript_text(&self) -> String

Returns the prompt text as it should be written into persisted transcripts.

Inline [Image #n] markers are preserved verbatim. If attachment metadata somehow survives without its placeholder still present in the text, the missing placeholders are appended in attachment order so the transcript does not silently become text-only.

Trait Implementations

impl Clone for TurnPrompt

fn clone(&self) -> TurnPrompt

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TurnPrompt

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for TurnPrompt

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for TurnPrompt

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

Formats the value using the given formatter.

impl Eq for TurnPrompt

impl From<&TurnPrompt> for TurnPrompt

fn from(prompt: &TurnPrompt) -> TurnPrompt

Converts to this type from the input type.

impl From<&str> for TurnPrompt

fn from(text: &str) -> TurnPrompt

Converts to this type from the input type.

impl From<String> for TurnPrompt

fn from(text: String) -> TurnPrompt

Converts to this type from the input type.

impl PartialEq for TurnPrompt

fn eq(&self, other: &TurnPrompt) -> 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 PartialEq<&str> for TurnPrompt

fn eq(&self, other: &&str) -> 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 PartialEq<TurnPrompt> for &str

fn eq(&self, other: &TurnPrompt) -> 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 TurnPrompt

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.

impl StructuralPartialEq for TurnPrompt