Struct GraphConfig 

pub struct GraphConfig {
    pub thread_id: Option<String>,
    pub trace_id: Option<String>,
    pub trace_ctx: Option<TraceCtx>,
    pub recursion_limit: usize,
    pub max_parallelism: usize,
    pub tags: Vec<String>,
    pub metadata: HashMap<String, Value>,
    pub configurable: HashMap<String, Value>,
}

Runtime configuration for graph execution.

Fields

thread_id: Option<String>

Thread ID for checkpointing and state management

trace_id: Option<String>

Trace ID for cross-crate correlation. If None, one is generated automatically at execution start.

Phase status: compatibility / migration-only

This field uses String for backward compatibility. The canonical replacement is trace_ctx. Use trace_ctx() to obtain the canonical form.

Removal condition: removed when all callers migrate to trace_ctx.

trace_ctx: Option<TraceCtx>

Canonical trace context for cross-crate correlation.

When set, takes precedence over the legacy trace_id field. If both are None, a new TraceCtx is generated at execution start.

recursion_limit: usize

Maximum recursion depth (default: 100)

max_parallelism: usize

Maximum number of parallel nodes in a single superstep. Hard-capped at 32. Default: 8.

tags: Vec<String>

Tags for filtering and organization

metadata: HashMap<String, Value>

Metadata attached to the execution

configurable: HashMap<String, Value>

User-provided configurable values accessible by nodes

Implementations

impl GraphConfig

pub fn new() -> Self

pub fn with_thread_id(self, id: impl Into<String>) -> Self

pub fn with_recursion_limit(self, limit: usize) -> Self

pub fn with_tag(self, tag: impl Into<String>) -> Self

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

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

pub fn with_trace_id(self, id: impl Into<String>) -> Self

pub fn with_max_parallelism(self, n: usize) -> Self

pub fn resolve_trace_ctx(&self) -> TraceCtx

Resolve the canonical stack_ids::TraceCtx for this config.

Resolution order:

1. self.trace_ctx if set (canonical path).
2. self.trace_id converted via TraceCtx::from_legacy_trace_id (compat path).
3. Generates a new TraceCtx if neither is set.

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

Set the canonical trace context.

Also back-fills the legacy trace_id field for compat consumers.

Trait Implementations

impl Clone for GraphConfig

fn clone(&self) -> GraphConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for GraphConfig

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

Formats the value using the given formatter.

impl Default for GraphConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for GraphConfig

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for GraphConfig

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

where __S: Serializer,

Serialize this value into the given Serde serializer.