Struct SystemRef 

pub struct SystemRef {
    pub uri: String,
    pub sha256: String,
    pub size_bytes: u64,
    pub mode: SystemRefMode,
}

GH #31: a by-reference pointer to a baked system_prompt too large to inline into WorkerPayload.system — the fetch-time alternative chosen by Engine::fetch_worker_payload{,_trusted} once the rendered string exceeds SystemRefConfig.threshold_bytes. Carries enough to let a SubAgent (or any caller re-emitting this payload) fetch and verify the referenced content without re-deriving it from engine state.

Fields

uri: String

Scheme-qualified location of the full system_prompt body. mode: File carries a file://<path> URI (the exact path SystemRefMode::File wrote to). mode: Http carries only the path portion the engine can construct on its own (/v1/worker/prompt/system?task_id=<id>&attempt=<n>) — see SystemRefMode::Http’s doc for why the engine cannot fill in scheme/host itself, and who is responsible for doing so.

sha256: String

Lowercase hex-encoded SHA-256 digest of the full referenced system_prompt string (the same bytes size_bytes measures), letting a fetcher verify the content it retrieves from uri matches what was baked at dispatch time.

size_bytes: u64

Byte length of the referenced system_prompt content itself (not of uri, not of any wrapper/envelope around it).

mode: SystemRefMode

Which delivery mechanism uri uses — see SystemRefMode.

Trait Implementations

impl Clone for SystemRef

fn clone(&self) -> SystemRef

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SystemRef

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for SystemRef

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl JsonSchema for SystemRef

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

impl PartialEq for SystemRef

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for SystemRef

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 SystemRef