Struct HelperContext 

pub struct HelperContext<'a> {
    pub content: &'a str,
    pub candidates: &'a [MemoryHandle],
    pub content_embedding: Option<&'a [f32]>,
    pub namespace: Option<&'a str>,
}

Borrowed runtime inputs threaded into Phase 1 deterministic helper stages. The Form 3 executor constructs ONE of these per run() and reuses it across every helper stage so the content string is passed by reference, not cloned per-helper (issue #782 PERF-11).

The fields are public so test scaffolding under cfg(test) can construct a context directly; production callers go through the executor.

Fields

content: &'a str

Incoming content slice — borrowed from the caller’s owned String. The same &str is threaded into every helper stage within a run, so content.as_ptr() is stable across stages. This is the load-bearing invariant pinned by the multistep_phase_1_helpers_receive_content_borrow_not_clone integration test.

candidates: &'a [MemoryHandle]

Candidate memory set — borrowed slice, not cloned.

content_embedding: Option<&'a [f32]>

Optional caller-supplied embedding for the content (cosine pre-filter input).

namespace: Option<&'a str>

Optional namespace hint forwarded to the FTS classifier.

Implementations

impl<'a> HelperContext<'a>

pub fn new( content: &'a str, candidates: &'a [MemoryHandle], content_embedding: Option<&'a [f32]>, namespace: Option<&'a str>, ) -> Self

Construct a borrowed context from the runtime inputs.

pub fn effective_content<'p>(&self, params: &'p HelperParams) -> &'p str

where 'a: 'p,

Resolve the effective content slice for this invocation. The descriptor params.content wins when non-empty (rare pipeline override); otherwise the context’s borrowed slice is returned verbatim. No String allocation.

Trait Implementations

impl<'a> Clone for HelperContext<'a>

fn clone(&self) -> HelperContext<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Copy for HelperContext<'a>

impl<'a> Debug for HelperContext<'a>

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

Formats the value using the given formatter.