Struct MobBootstrapSpec 

pub struct MobBootstrapSpec {
    pub definition: MobDefinition,
    pub storage: MobStorage,
    pub session_service: Arc<dyn MobSessionService>,
    pub binary_blob_store: Option<Arc<dyn BinaryBlobStore>>,
    pub options: MobBootstrapOptions,
    pub runtime_adapter: Option<Arc<MeerkatMachine>>,
    /* private fields */
}

Specification for bootstrapping a mob runtime from a definition, storage, and session service.

Fields

definition: MobDefinition

storage: MobStorage

session_service: Arc<dyn MobSessionService>

binary_blob_store: Option<Arc<dyn BinaryBlobStore>>

options: MobBootstrapOptions

runtime_adapter: Option<Arc<MeerkatMachine>>

Explicit runtime adapter — bypasses session_service.runtime_adapter().

Used by persistent() to supply the adapter directly so the session service’s runtime_store can stay None (keeping the checkpointer enabled). See meerkat-session#checkpointer-enabled-flag.

Implementations

impl MobBootstrapSpec

pub fn new( definition: MobDefinition, storage: MobStorage, session_service: Arc<dyn MobSessionService>, ) -> Self

pub fn with_options(self, options: MobBootstrapOptions) -> Self

pub fn with_session_runtime_adapter(self, adapter: Arc<MeerkatMachine>) -> Self

Expose a runtime adapter through the session-service facade.

Custom embedders that construct their own MobSessionService still need MobKit’s session-service surface to report the same runtime authority that MobBuilder::with_runtime_adapter(...) receives. This keeps autonomous-host comms, runtime inspection, and control paths pointed at one machine without forcing embedders through the stock factory helpers.

pub fn with_after_create_hook(self, hook: AfterCreateHook) -> Self

Wrap the session service with an after-create hook that fires after each successful create_session. The hook is best-effort: errors are not propagated. Uses AfterCreateMobSessionService which wraps the inner service without a pre-build hook, so any pre-build mutations from inner wrappers are fully reflected in the context.

pub fn ephemeral( definition: MobDefinition, storage: MobStorage, store_path: PathBuf, max_sessions: usize, session_store: Option<Arc<dyn AgentSessionStore>>, ) -> Self

Build an ephemeral session service with a correctly wired AgentFactory.

If session_store is provided, it is set on the FactoryAgentBuilder so that agents use the given store instead of falling back to JSONL.

pub fn ephemeral_with_hook( definition: MobDefinition, storage: MobStorage, store_path: PathBuf, max_sessions: usize, session_store: Option<Arc<dyn AgentSessionStore>>, hook: impl Fn(&mut CreateSessionRequest) -> Pin<Box<dyn Future<Output = Result<(), SessionError>> + Send + '_>> + Send + Sync + 'static, ) -> Self

Like ephemeral, but with a pre-build hook that is called before each agent is constructed. Use this to inject external tools, augment system prompts, or set per-agent labels.

pub fn persistent( definition: MobDefinition, storage: MobStorage, store_path: PathBuf, max_sessions: usize, session_store: Arc<dyn SessionStore>, ) -> Self

Build a persistent session service with a correctly wired AgentFactory.

The session_store is used in two places:

1. As the persistence backend for PersistentSessionService (checkpoint/restore).
2. Adapted via StoreAdapter and set on FactoryAgentBuilder.default_session_store so that agents use it directly instead of falling back to JSONL.

pub fn persistent_with_hook( definition: MobDefinition, storage: MobStorage, store_path: PathBuf, max_sessions: usize, session_store: Arc<dyn SessionStore>, hook: impl Fn(&mut CreateSessionRequest) -> Pin<Box<dyn Future<Output = Result<(), SessionError>> + Send + '_>> + Send + Sync + 'static, ) -> Self

Like persistent, but with a pre-build hook that is called before each agent is constructed. Use this to inject external tools, augment system prompts, or set per-agent labels.