Struct ExecCtxBuilder 

pub struct ExecCtxBuilder { /* private fields */ }

Builder for ExecCtx.

Implementations

impl ExecCtxBuilder

pub fn client(self, client: Client) -> Self

Set the HTTP client. If not set, a default client is created.

pub fn backend(self, backend: Arc<dyn Backend>) -> Self

Set the LLM backend. Default: OllamaBackend.

pub fn backoff(self, config: BackoffConfig) -> Self

Set the transport retry configuration. Default: BackoffConfig::none().

pub fn vars(self, vars: HashMap<String, String>) -> Self

Set all template variables at once.

pub fn var(self, key: impl Into<String>, value: impl Into<String>) -> Self

Insert a single template variable.

pub fn cancellation(self, cancel: Option<Arc<AtomicBool>>) -> Self

Set the cancellation flag.

pub fn event_handler(self, handler: Arc<dyn EventHandler>) -> Self

Set the event handler.

pub fn timeout(self, timeout: Duration) -> Self

Set the client-level connection timeout. Default: 5 minutes (safety net).

This is a coarse safety net on the reqwest::Client. Per-request timeouts are applied individually via PipelineLimits::request_timeout or LlmCall::with_timeout.

If a custom Client is provided via .client(), this setting is ignored (the custom client’s own timeout applies).

pub fn with_trace_id(self, trace_id: TraceId) -> Self

👎Deprecated since 0.6.0:

Use with_trace_ctx() instead. This method will be removed in v1.0.

Phase status: compatibility / migration-only

Set the legacy trace ID for correlating operations. If not set, a random UUID v4 is generated automatically.

Prefer with_trace_ctx for new code.

Removal condition: removed when all callers migrate to TraceCtx.

pub fn with_trace_ctx(self, trace_ctx: TraceCtx) -> Self

Set the canonical trace context from stack_ids::TraceCtx.

This is the normal-path trace form. When set, the legacy trace_id field is derived from trace_ctx.trace_id for backward compatibility.

pub fn with_limits(self, limits: PipelineLimits) -> Self

Set resource limits. If not set, PipelineLimits::default() is used.

pub fn build(self) -> ExecCtx

Build the execution context.

Preferred: use with_trace_ctx() to set trace identity. The legacy with_trace_id() method is deprecated.

Resolution order for trace identity:

1. (Canonical) If trace_ctx was set explicitly via with_trace_ctx(), use it. Derive legacy trace_id from it at the compatibility boundary.
2. (Legacy/compat) If only trace_id was set via deprecated with_trace_id(), derive trace_ctx from it.
3. (Default) If neither was set, generate a fresh TraceCtx and derive legacy trace_id.

The legacy trace_id is always derived — never independently generated — when trace_ctx is present. This ensures a single source of truth for trace identity.