Struct FormatPolicy 

pub struct FormatPolicy {
    pub format: OutputFormat,
    pub metadata: MetadataLevel,
    pub ordering: Ordering,
    pub sections: SectionConfig,
    pub token_budget: Option<usize>,
    pub grain_overrides: HashMap<GrainType, GrainTypeOverride>,
    pub query_text: Option<String>,
    pub grain_type_diversity: Option<GrainTypeDiversityConfig>,
}

Complete formatting policy. Constructed via builder pattern.

Fields

format: OutputFormat

metadata: MetadataLevel

ordering: Ordering

sections: SectionConfig

token_budget: Option<usize>

grain_overrides: HashMap<GrainType, GrainTypeOverride>

query_text: Option<String>

Original query text. Used by Knowledge Update chain rendering to detect recency intent (“currently”, “most recently”, etc.) for update-only suppression mode.

grain_type_diversity: Option<GrainTypeDiversityConfig>

Grain type diversity floor. When Some, the budget allocator reserves slots for underrepresented grain types before filling by priority. Default: Some(GrainTypeDiversityConfig::default()).

Implementations

impl FormatPolicy

pub fn new(format: OutputFormat) -> Self

pub fn metadata(self, level: MetadataLevel) -> Self

pub fn ordering(self, ordering: Ordering) -> Self

pub fn token_budget(self, budget: usize) -> Self

pub fn group_by_type(self) -> Self

pub fn grain_override(self, gt: GrainType, ovr: GrainTypeOverride) -> Self

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

Set the original query text for recency detection in KU rendering.

pub fn grain_type_diversity(self, config: GrainTypeDiversityConfig) -> Self

Set grain type diversity configuration.

pub fn no_grain_type_diversity(self) -> Self

Disable grain type diversity floor (pure priority allocation).

impl FormatPolicy

pub fn claude() -> Self

SML format, minimal metadata, relevance-ordered, grouped by type. Optimized for Claude models which handle SML context natively.

pub fn gpt4() -> Self

Markdown format, minimal metadata, relevance-ordered. Good for GPT-4, GPT-4o, and similar models.

pub fn gemini() -> Self

Markdown format, minimal metadata, relevance-ordered. Alias for gpt4() — Gemini also handles markdown well.

pub fn local_small() -> Self

Plain text, no metadata, relevance-ordered. For small local models with tight context windows.

pub fn json_api() -> Self

JSON format, full metadata, relevance-ordered. For programmatic consumers, A2A, and API responses.

Trait Implementations

impl Clone for FormatPolicy

fn clone(&self) -> FormatPolicy

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FormatPolicy

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

Formats the value using the given formatter.

impl Default for FormatPolicy

fn default() -> Self

Returns the “default value” for a type.