Struct RunOptions 

pub struct RunOptions {

    pub profile: Profile,
    pub entry_flow: Option<String>,
    pub entry_node: Option<String>,
    pub input: Value,
    pub ctx: TenantContext,
    pub transcript: Option<Arc<dyn Fn(&Value) + Sync + Send>>,
    pub otlp: Option<OtlpHook>,
    pub mocks: MocksConfig,
    pub artifacts_dir: Option<PathBuf>,
    pub signing: SigningPolicy,
    pub components_dir: Option<PathBuf>,
    pub components_map: HashMap<String, PathBuf>,
    pub dist_offline: bool,
    pub dist_cache_dir: Option<PathBuf>,
    pub allow_missing_hash: bool,
    pub secrets_manager: Option<Arc<dyn SecretsManager>>,
    pub cross_pack_resolver: Option<Arc<dyn CrossPackResolver>>,
    pub session_state_dir: Option<PathBuf>,
}

User supplied options for a run.

Fields

profile: Profile

entry_flow: Option<String>

entry_node: Option<String>

Start the run at this node instead of the flow’s declared entrypoint.

Card-driven messaging packs carry the id of the next node to run on the inbound activity. Without this the host can only restart at the entrypoint on every turn, so the nodes chained between two rendered cards never execute.

A persisted resume snapshot WINS over this: it means a card is parked awaiting the user’s submit, and only re-dispatching that card attaches the submitted answers to its output for the nodes downstream to read. So this drives the FIRST hop into a flow, and resume drives the rest.

A node id the flow does not have is an error, never a silent fall back to the entrypoint.

input: Value

ctx: TenantContext

transcript: Option<Arc<dyn Fn(&Value) + Sync + Send>>

otlp: Option<OtlpHook>

mocks: MocksConfig

artifacts_dir: Option<PathBuf>

signing: SigningPolicy

components_dir: Option<PathBuf>

components_map: HashMap<String, PathBuf>

dist_offline: bool

dist_cache_dir: Option<PathBuf>

allow_missing_hash: bool

secrets_manager: Option<Arc<dyn SecretsManager>>

Optional secrets manager override used by embedded runtimes that need to share a caller-owned secrets backend with the runner.

cross_pack_resolver: Option<Arc<dyn CrossPackResolver>>

Optional cross-pack resolver for provider.invoke nodes that reference providers in other packs (e.g., OAuth broker from a capability pack).

session_state_dir: Option<PathBuf>

Directory where suspended FlowSnapshots are persisted between activities so a conversational flow can resume at the node the previous run paused at (instead of restarting from the entry).

Snapshots are keyed by ctx.session_id, so the caller must populate ctx.session_id with a stable per-conversation identifier (e.g. {tenant}:{flow}:{conversation_id}) for resume to engage. When either this directory or session_id is missing, the runner behaves exactly as before: a FlowExecution::waiting result is surfaced as an Err and the snapshot is dropped.

Trait Implementations

impl Clone for RunOptions

fn clone(&self) -> RunOptions

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RunOptions

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

Formats the value using the given formatter.

impl Default for RunOptions

fn default() -> RunOptions

Returns the “default value” for a type.