Enum ContentRef 

pub enum ContentRef {
    Inline {
        value: Value,
    },
    FileRef {
        path: PathBuf,
        mime: Option<String>,
        size_hint: Option<u64>,
    },
}

How content travels — inline value or file path. Streaming is not carried as its own variant in this iteration.

The SpawnerAdapter picks the appropriate variant at the boundary. When metadata is unavailable it is acceptable to fall back to Inline with the raw value, prioritising basic functionality over metadata fidelity.

Variants

Inline

Inline JSON. Kilobyte-scale, the default for structured data.

Fields

value: Value

JSON body.

FileRef

File-path handoff for large / binary / artifact content. File ownership and cleanup belong to the engine side (carry); the spawner only hands the path over.

Fields

path: PathBuf

File path.

mime: Option<String>

MIME hint.

size_hint: Option<u64>

Size hint in bytes.

Implementations

impl ContentRef

pub fn inline(value: Value) -> Self

Wrap a serde_json::Value as an Inline content ref.

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

Wrap raw text as an Inline content ref (the common path for a ProcessSpawner running in plain mode).

pub fn file_ref( path: impl Into<PathBuf>, mime: Option<String>, size_hint: Option<u64>, ) -> Self

FileRef helper. Fill in mime / size_hint when the spawner knows them.

Trait Implementations

impl Clone for ContentRef

fn clone(&self) -> ContentRef

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ContentRef

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ContentRef

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ContentRef

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

where __S: Serializer,

Serialize this value into the given Serde serializer.