Struct BriefBuilder 

pub struct BriefBuilder { /* private fields */ }

Assembles a Brief from registered Sources.

See the module-level docs for usage. The default tokenizer is CharApproxTokenizer (≈ 4 chars per token); the default governance is NoOpGovernance; the default strategy is PruneStrategy::default (== PruneStrategy::ImportanceFirst).

Implementations

impl BriefBuilder

pub fn new() -> Self

Construct a fresh builder with no sources, the default CharApproxTokenizer, NoOpGovernance, the default TokenBudget (8000 total / 1024 reserved), and PruneStrategy::ImportanceFirst.

pub fn source(self, source: Arc<dyn Source>) -> Self

Register a Source. Duplicate SourceIds are rejected at BriefBuilder::build time, not here.

pub fn governance(self, governance: Arc<dyn Governance>) -> Self

Swap the Governance hook. Defaults to NoOpGovernance.

pub fn tokenizer(self, tokenizer: Arc<dyn Tokenizer>) -> Self

Swap the Tokenizer. Defaults to CharApproxTokenizer.

pub fn budget(self, budget: TokenBudget) -> Self

Set the TokenBudget used for pruning.

pub fn strategy(self, strategy: PruneStrategy) -> Self

Set the PruneStrategy. Defaults to PruneStrategy::ImportanceFirst.

pub fn sources(&self) -> &[Arc<dyn Source>]

Borrowed view of the configured sources. Useful for tests.

pub fn current_budget(&self) -> &TokenBudget

The configured budget.

pub async fn build(&self, ctx: &BriefContext) -> Result<Brief>

Assemble the Brief for ctx.

Steps:

1. Reject duplicate SourceIds.
2. Fan out to every source in parallel via join_all. Per-source errors surface in step 4 — fan-out itself never fails.
3. Tokenize each surviving Contribution using the active Tokenizer (source-provided estimated_tokens is treated as a hint only).
4. Apply budget pruning via apply_budget.
5. Assemble draft Brief (system concatenation, message order preserved within priority, tools collected).
6. Run Governance::review. Allow / Redacted advance; Rejected surfaces as BriefError::Rejected.
7. Build the BriefReceipt with per-source stats, drops, and timings.

On any fatal source error (anything other than SourceError::Skipped), build returns BriefError::Source. Skipped sources are silently treated as zero contributions.

Trait Implementations

impl Debug for BriefBuilder

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

Formats the value using the given formatter.

impl Default for BriefBuilder

fn default() -> Self

Returns the “default value” for a type.