Struct SystemPrompt 

pub struct SystemPrompt { /* private fields */ }

Ordered sequence of SystemBlocks. An empty SystemPrompt represents “no system prompt” — codecs treat it as if the field were absent.

Storage is Arc<[SystemBlock]> so cloning a SystemPrompt (and the crate::ir::ModelRequest that holds it) is an atomic refcount bump. The hot-path cost of stamping the same prompt on every model call is O(1) regardless of block count or block length.

Implementations

impl SystemPrompt

pub fn empty() -> Self

Empty prompt — semantically equivalent to “no system prompt configured.”

pub fn text(text: impl Into<String>) -> Self

Single-block prompt from a text string.

pub fn cached(text: impl Into<String>, cache: CacheControl) -> Self

Single-block prompt with the supplied cache directive.

pub fn is_empty(&self) -> bool

Whether the prompt contains zero blocks.

pub fn len(&self) -> usize

Number of blocks.

pub fn blocks(&self) -> &[SystemBlock]

Borrow the blocks in order.

pub fn any_cached(&self) -> bool

Whether any block carries a cache directive — used by codecs without native cache support to decide whether to emit a LossyEncode warning.

pub fn map_blocks<F>(&self, f: F) -> Self

where F: FnMut(&mut SystemBlock),

Map every block through f, returning a fresh prompt whose shared storage is rebuilt from the transformed sequence. The canonical PII-redaction surface — redactors clone each block, scrub the text in place, and assemble a fresh Arc<[SystemBlock]> once. The original Arc is never mutated; callers retaining a clone of the source prompt see it untouched.

(Arc::try_unwrap fast-pathing the sole-owner case isn’t available because Rust’s stdlib does not implement try_unwrap for Arc<[T]> — slice DSTs aren’t Sized.)

pub fn concat_text(&self) -> String

Concatenate every block’s text with \n\n separators — the canonical “flatten to single string” rendering codecs without per-block channels rely on.

Trait Implementations

impl Clone for SystemPrompt

fn clone(&self) -> SystemPrompt

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SystemPrompt

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

Formats the value using the given formatter.

impl Default for SystemPrompt

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for SystemPrompt

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<&str> for SystemPrompt

fn from(s: &str) -> Self

Converts to this type from the input type.

impl From<String> for SystemPrompt

fn from(s: String) -> Self

Converts to this type from the input type.

impl From<SystemBlock> for SystemPrompt

fn from(block: SystemBlock) -> Self

Converts to this type from the input type.

impl From<Vec<SystemBlock>> for SystemPrompt

fn from(blocks: Vec<SystemBlock>) -> Self

Converts to this type from the input type.

impl PartialEq for SystemPrompt

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

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for SystemPrompt

impl StructuralPartialEq for SystemPrompt