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) -> Self

Creates a text-only prompt payload.

pub fn from_agent_data(text: String) -> Self

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

Formats the value using the given formatter.

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

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for TurnPrompt

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

Formats the value using the given formatter.

impl Eq for TurnPrompt

impl From<&TurnPrompt> for TurnPrompt

fn from(prompt: &TurnPrompt) -> Self

Converts to this type from the input type.

impl From<&str> for TurnPrompt

fn from(text: &str) -> Self

Converts to this type from the input type.

impl From<String> for TurnPrompt

fn from(text: String) -> Self

Converts to this type from the input type.

impl PartialEq for TurnPrompt

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

Equality operator ==.

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

Inequality operator !=.

impl PartialEq<&str> for TurnPrompt

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

Equality operator ==.

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

Inequality operator !=.

impl PartialEq<TurnPrompt> for &str

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for TurnPrompt

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 TurnPrompt