Struct SessionConfig 

pub struct SessionConfig {

    pub continue_session: Option<Option<String>>,
    pub system: Option<String>,
    pub prompt_manifest: Option<PathBuf>,
    pub cwd: Option<PathBuf>,
    pub env: Option<SessionEnv>,
    pub env_stripped: Vec<String>,
    pub auto_approve_confirms: bool,
    pub model_override: Option<String>,
    pub persist: bool,
    pub auto_compact: bool,
    pub compaction_policy: CompactionPolicyWire,
    pub await_extensions: bool,
    pub keep_warm: bool,
    pub name: Option<String>,
    pub max_session_cost: Option<f64>,
}

Everything EngineHost::create_session needs. Serializable: it is the payload of the wire Attach::Create. Mirrors EngineOpts minus the host-level fields (profile, no_extensions), plus the per-session facts a daemon cannot inherit from its own process (cwd, env overlay).

Fields

continue_session: Option<Option<String>>

EngineOpts.continue_session. Some(None) = bare --continue (most recent journal). Plain serde encodes Some(None) as null and decodes that as None, so the daemon could never receive a bare --continue (soak F21) — double_option keeps the two levels apart on the wire.

system: Option<String>

EngineOpts.system.

prompt_manifest: Option<PathBuf>

EngineOpts.prompt_manifest.

cwd: Option<PathBuf>

Per-session working directory. None = process cwd (in-process hosts pass None today → byte-identical). The daemon ALWAYS fills it from Hello.cwd.

env: Option<SessionEnv>

Per-session environment snapshot. None = inherit process env (in-process hosts). The daemon fills it from Hello.env on Attach::Create only; attaching to an existing session does not change the creator’s env.

env_stripped: Vec<String>

Names of environment variables stripped as secrets at the client (e.g. GH_TOKEN, AWS_SECRET_ACCESS_KEY). NOT the SYNAPS_* prefixes (those are noise). Used for loud notices when a tool fails referencing a stripped secret. Persisted in the journal (names only, never values).

auto_approve_confirms: bool

Confirm hook results auto-approved (server --auto-approve-confirms). Interactive hosts: false.

model_override: Option<String>

CLI --model override applied after session resolution.

persist: bool

Save policy: only “save at all” — the TUI/chat/rpc always save; tests may disable. Default true.

auto_compact: bool

Headless-chat policy: after every turn, save + assess_context and auto-compact when the engine budget says so (chat.rs post-turn block). The TUI does its own compaction; default false.

compaction_policy: CompactionPolicyWire

Compaction transition policy: InPlace (default; chat, today’s actor) or LinkedSuccessor (the TUI’s successor-session chain).

await_extensions: bool

Block create on process-level extension discovery before emitting on_session_start (chat/daemon). The TUI passes false: the actor emits it from a spawned waiter so boot never blocks on discovery.

keep_warm: bool

Never Park this session (--keep-warm). Default false.

name: Option<String>

--name: name the session at create (same rules as /cmd saveas; must be unique among saved sessions). Applied before the registry entry is written so synaps send --session <name> resolves at once.

max_session_cost: Option<f64>

(E-P7, §S3) Hard per-session spend ceiling in USD. None = unbounded. Checked after every Usage stream event; a breach cancels the turn, revokes any armed driver, and emits CostCapReached. This is the host-owned circuit breaker for an actor-resident autonomous driver.

Trait Implementations

impl Clone for SessionConfig

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SessionConfig

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

Formats the value using the given formatter.

impl Default for SessionConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for SessionConfig

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for SessionConfig

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

where __S: Serializer,

Serialize this value into the given Serde serializer.