Struct RuntimeOptions 

pub struct RuntimeOptions {

    pub provider: Box<dyn LLMProvider>,
    pub execution_plane: Option<Box<dyn ExecutionPlane>>,
    pub session_log: Option<Arc<dyn SessionLog>>,
    pub compression_store: Option<Arc<dyn ArchiveStore>>,
    pub session_id: Option<String>,
    pub max_tokens: u32,
    pub max_turns: Option<u32>,
    pub timeout_ms: Option<u64>,
    pub extensions: Option<Value>,
    pub agent_id: Option<String>,
    pub pre_query_memory: Option<Arc<dyn Fn(&str) -> Vec<String> + Send + Sync>>,
    pub system_prompt: Option<String>,
    pub initial_memory: Vec<String>,
    pub skill_dir: Option<PathBuf>,
    pub dream_store: Option<Box<dyn DreamStore>>,
    pub knowledge_source: Option<Box<dyn KnowledgeSource>>,
    pub signal_source: Option<Box<dyn SignalSource>>,
    pub governance: Option<Arc<Mutex<Governance>>>,
    pub os_profile: Option<OsProfile>,
    pub governance_policy: Option<GovernancePolicy>,
    pub attention_policy: Option<AttentionPolicy>,
    pub scheduler_budget: Option<SchedulerBudget>,
    pub resource_quota: Option<ResourceQuota>,
    pub memory_policy: Option<MemoryPolicy>,
    pub tokenizer: Option<String>,
    pub enable_plan_tool: Option<bool>,
    pub on_tool_suspend: Option<ToolSuspendHandler>,
    pub on_permission_request: Option<PermissionRequestHandler>,
    pub milestone_policy: MilestonePolicy,
    pub milestone_contract: Option<MilestoneContract>,
    pub run_spec: Option<AgentRunSpec>,
    pub allowed_tool_ids: Option<Vec<String>>,
    pub on_turn_metrics: Option<OnTurnMetricsHandler>,
    pub stable_core_tool_ids: Vec<String>,
    pub on_milestone_evaluate: Option<MilestoneEvaluationHandler>,
}

Configuration for a RuntimeRunner (aligned with Node/Python RuntimeOptions).

Fields

provider: Box<dyn LLMProvider>

execution_plane: Option<Box<dyn ExecutionPlane>>

session_log: Option<Arc<dyn SessionLog>>

compression_store: Option<Arc<dyn ArchiveStore>>

session_id: Option<String>

When set, execute reuses this session id.

max_tokens: u32

max_turns: Option<u32>

timeout_ms: Option<u64>

extensions: Option<Value>

agent_id: Option<String>

pre_query_memory: Option<Arc<dyn Fn(&str) -> Vec<String> + Send + Sync>>

I4: optional run-start memory pre-fetch hook. The runner calls this once per run, before the first LLM turn, with the goal string; each returned query becomes a dream_store.search and the resulting hits page into the knowledge partition before turn 1. Mirrors the Node SDK preQueryMemory. Sync-only in Rust today — async hosts can pre-compute. Errs-open when dream_store or agent_id is missing.

system_prompt: Option<String>

initial_memory: Vec<String>

skill_dir: Option<PathBuf>

dream_store: Option<Box<dyn DreamStore>>

knowledge_source: Option<Box<dyn KnowledgeSource>>

signal_source: Option<Box<dyn SignalSource>>

governance: Option<Arc<Mutex<Governance>>>

os_profile: Option<OsProfile>

governance_policy: Option<GovernancePolicy>

attention_policy: Option<AttentionPolicy>

scheduler_budget: Option<SchedulerBudget>

resource_quota: Option<ResourceQuota>

memory_policy: Option<MemoryPolicy>

Opt-in long-term memory policy (set_memory_policy), enforced at the kernel memory traps.

tokenizer: Option<String>

enable_plan_tool: Option<bool>

on_tool_suspend: Option<ToolSuspendHandler>

on_permission_request: Option<PermissionRequestHandler>

milestone_policy: MilestonePolicy

How to handle EvaluateMilestone actions. Default: RequireVerifier.

milestone_contract: Option<MilestoneContract>

run_spec: Option<AgentRunSpec>

allowed_tool_ids: Option<Vec<String>>

P0-A tool gating: a static per-run tool profile — only these tool ids (plus the skill/memory/knowledge/update_plan meta-tools) are exposed to the model each turn. Lowers to the same capability_filter sub-agents use; byte-stable across the run, so it never busts the prompt-cache prefix. Augments run_spec’s filter when both are set; synthesizes a minimal top-level spec otherwise. None/empty ⇒ no gating (no config = old).

on_turn_metrics: Option<OnTurnMetricsHandler>

P0-C: optional per-turn metrics sink for tool-gating telemetry (see TurnMetrics). Pure observation; invoked once per LLM turn. Panics are not caught — keep the sink trivial.

stable_core_tool_ids: Vec<String>

P1-B/D stable-core: tool ids always exposed under skill gating. Empty ⇒ skills narrow to exactly their declared tools + meta-tools. Opt-in: no skill declaring tools ⇒ never engages.

on_milestone_evaluate: Option<MilestoneEvaluationHandler>