Struct ContextFragment 

pub struct ContextFragment {
    pub id: Option<u64>,
    pub content: String,
    pub path: Option<String>,
    pub kind: Option<String>,
    pub priority: Option<u8>,
    pub metadata: Option<Map<String, Value>>,
    pub media: Option<MediaRef>,
}

One unit of caller-supplied context to compile.

Fields

id: Option<u64>

Caller-side identifier. When absent, the compiler derives a stable content-addressed id (see super::fragment_id). Accepts a JSON number or a decimal string on input (see [super::wire::deserialize_optional_id]) — a caller that got a fragment_id back as a string (e.g. under CompilePolicy::ids_as_strings) can resubmit it unchanged.

content: String

The fragment text. #[serde(default)] (V2b-1): a path fragment carries no content on the wire — the adapter resolves path into content in a pre-pass before the pure compiler core ever sees the request, so this stays the only field the core reads.

path: Option<String>

Read this file’s content from disk in place of an inline content (V2b-1 path ingestion). path is EXCLUSIVE — it is resolved into content before the compiler core runs, so a fragment carrying path together with content or media is rejected. content and media together are fine, and are the intended shape for an image and its caption. A fragment carrying none of the three is rejected as well. Requires the server to be started with VELESDB_MEMORY_INGEST_ROOTS set (a colon/semicolon-separated allowlist of directories, platform PATH-list syntax); otherwise every path fragment fails with an explicit “ingestion disabled” error. The path must be absolute and resolve (after following symlinks) to a plain file under one of the configured roots, no larger than crate::limits::MAX_INGEST_FILE_BYTES and valid UTF-8. The pure compiler core never reads this field — resolution is an adapter-side I/O pre-pass (see the crate’s context::ingest module); a path fragment that reaches super::ContextCompiler unresolved is rejected with crate::error::MemoryError::IngestDisabled.

kind: Option<String>

Free-form kind hint ("code", "log", "prose", …) — classification works without it, but honors it when present.

priority: Option<u8>

Caller priority, higher packs first (default 0).

metadata: Option<Map<String, Value>>

Caller metadata. Recognized keys: "verbatim": true forces ContextAction::Preserve; "cache": true forces ContextAction::Cache.

media: Option<MediaRef>

Inline media payload (US-009, PR1). None (the default) keeps every pre-0.9.0 request wire-compatible. When set, the fragment packs as one atomic piece — see MediaRef.

Trait Implementations

impl Clone for ContextFragment

fn clone(&self) -> ContextFragment

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ContextFragment

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ContextFragment

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl JsonSchema for ContextFragment

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 Serialize for ContextFragment

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

where __S: Serializer,

Serialize this value into the given Serde serializer.