Struct BridgeConfig 

pub struct BridgeConfig {

    pub llm_tx: Option<Sender<LlmRequest>>,
    pub ns: String,
    pub custom_metrics: CustomMetricsHandle,
    pub stats: StatsHandle,
    pub budget: BudgetHandle,
    pub progress: ProgressHandle,
    pub lib_paths: Vec<PathBuf>,
    pub variant_pkgs: Vec<VariantPkg>,
    pub state_store: Arc<JsonFileStore>,
    pub card_store: Arc<FileCardStore>,
    pub card_run_enabled: bool,
    pub scenarios_dir: PathBuf,
    pub nn_dir: PathBuf,
    pub log_sink: Option<LogSink>,
}

All handles needed by Layer 0 runtime primitives.

Collects the various per-session handles into a single config, avoiding a growing parameter list on register().

Fields

llm_tx: Option<Sender<LlmRequest>>

Channel for LLM requests (None for eval_simple sessions).

ns: String

Namespace for alc.state (from ctx._ns or “default”).

custom_metrics: CustomMetricsHandle

Custom metrics handle for alc.stats.record/get.

stats: StatsHandle

Stats handle for alc.stats.llm_calls() (auto-counted session metrics).

budget: BudgetHandle

Budget checker for LLM call limits.

progress: ProgressHandle

Progress reporter for alc.progress().

lib_paths: Vec<PathBuf>

Package search paths (needed by alc.fork to setup child VMs).

variant_pkgs: Vec<VariantPkg>

Variant pkg overrides (alc.local.toml) — propagated to fork children.

state_store: Arc<JsonFileStore>

State store for alc.state.* (service layer resolves the root).

card_store: Arc<FileCardStore>

Card store for alc.card.* (service layer resolves the root).

card_run_enabled: bool

Cached [setting.card].run value resolved at session start.

When false (default), alc.card.create / alc.card.append calls that carry a top-level run field become no-op: the closures return Lua nil without touching the card store or publishing a CardEvent. Calls without a run field are unaffected (Phase 1-B gate is additive — existing pkgs that never populate run see no behavioural change).

scenarios_dir: PathBuf

Scenarios directory exposed to Lua via alc._dirs.scenarios.

nn_dir: PathBuf

Store root for alc.nn model bundles.

Consumed by register_nn under the nn feature to construct the filesystem-backed [algocline_nn::FsStore] wired via [algocline_nn::install_store]. Resolved by the service layer via algocline_core::AppDir::nn_dir so the engine crate never touches $HOME / $ALC_HOME directly.

An empty PathBuf means “do not install a store” — alc.nn.save / alc.nn.load then error with "no NN store registered". Test sites that never exercise save/load can pass PathBuf::new. Ignored when the nn feature is disabled.

log_sink: Option<LogSink>

Per-session log-capture ring buffer.

Obtained from ExecutionMetrics::log_sink_handle(). Passed to alc.log and print() overrides so log output is routed into the ring buffer for alc_status recent_logs.

None for eval_simple / fork child sessions where observability is not needed; in that case log entries are emitted to tracing only.