Struct InProcessRuntimeBuilder 

pub struct InProcessRuntimeBuilder { /* private fields */ }

Builder for the public in-process runtime.

The builder owns a standalone runtime bundle:

• PlatformDefinition for capabilities and drivers
• in-memory stores for sessions, files, storage, memory, and messages
• seeded harness/agent/session entities

build() returns an InProcessRuntime that can execute turns in-process without the durable engine or the control-plane server.

Implementations

impl InProcessRuntimeBuilder

pub fn new() -> InProcessRuntimeBuilder

Create a builder with runtime-safe built-in capabilities and no implicit LLM driver.

Embedders must either:

• call Self::llm_sim for deterministic local examples/tests, or
• register their own driver(s) on the platform definition and set a default model via Self::default_model.

pub fn mcp_auth_provider( self, provider: Arc<dyn McpAuthProvider>, ) -> InProcessRuntimeBuilder

Set the auth provider used to acquire credentials for scoped MCP servers (knowledge/integrations/runtime-mcp.md D3). Defaults to no credentials, suitable for unauthenticated servers or servers carrying literal auth headers.

pub fn platform_definition( self, platform_definition: PlatformDefinition, ) -> InProcessRuntimeBuilder

Replace the platform definition used by the runtime.

pub fn capability<C>(self, capability: C) -> InProcessRuntimeBuilder

where C: Capability + 'static,

Register an additional capability on the runtime platform.

pub fn driver_registry( self, driver_registry: DriverRegistry, ) -> InProcessRuntimeBuilder

Replace the platform driver registry.

pub fn provider(self, provider: RuntimeProvider) -> InProcessRuntimeBuilder

Register a canonical runtime provider selected by ModelSpec.

pub fn llm_sim(self, config: LlmSimConfig) -> InProcessRuntimeBuilder

Register the built-in llmsim driver for deterministic local execution.

pub fn default_model(self, model: ResolvedModel) -> InProcessRuntimeBuilder

Set the runtime default model used when sessions/agents do not override it.

pub fn model_spec(self, model: ModelSpec) -> InProcessRuntimeBuilder

Select a credential-free model served by a provider registered on this builder.

pub fn backends(self, backends: HostBackends) -> InProcessRuntimeBuilder

Supply a custom backend bundle instead of the built-in in-memory stores.

pub fn workspace_policy( self, policy: WorkspacePolicy, ) -> InProcessRuntimeBuilder

Apply a backend-independent policy to the resolved session filesystem.

The policy wraps whichever factory the platform selected, so in-memory, host-disk, database, and custom providers receive identical access checks without changing their implementations.

pub fn with_session_task_registry( self, registry: Arc<dyn SessionTaskRegistry>, ) -> InProcessRuntimeBuilder

Inject a session-task registry. Convenience over backends(...) that initializes an in-memory backend bundle on first use, so embedders can add the registry without assembling a full HostBackends.

pub fn with_schedule_store_factory( self, factory: Arc<dyn Fn(i64) -> Arc<dyn SessionScheduleStore> + Sync + Send>, ) -> InProcessRuntimeBuilder

Inject a per-org schedule store factory (see HostBackends).

pub fn with_platform_store_factory( self, factory: Arc<dyn Fn(i64, TypedId<SessionIdMarker>) -> Arc<dyn PlatformStore> + Sync + Send>, ) -> InProcessRuntimeBuilder

Inject a per-(org, session) platform store factory (see HostBackends).

pub fn session_file_system_factory_context( self, context: SessionFileSystemFactoryContext, ) -> InProcessRuntimeBuilder

Supply host dependencies needed by the platform session filesystem factory.

pub fn provider_retry_config( self, config: LlmRetryConfig, ) -> InProcessRuntimeBuilder

Override the bounded provider-recovery policy for this runtime.

pub fn provider_stall_timeout( self, timeout: Duration, ) -> InProcessRuntimeBuilder

Override the no-output provider stream stall timeout.

pub fn harness(self, harness: Harness) -> InProcessRuntimeBuilder

Seed a harness into the runtime store.

pub fn agent(self, agent: Agent) -> InProcessRuntimeBuilder

Seed an agent into the runtime store.

pub fn session(self, session: Session) -> InProcessRuntimeBuilder

Seed a session into the runtime store.

pub fn single_session<F>(self, configure: F) -> InProcessRuntimeBuilder

where F: FnOnce(SingleSessionBuilder) -> SingleSessionBuilder,

Seed one harness, one agent, and one session with a compact sub-builder.

The generated session id is exposed from the built runtime via InProcessRuntime::default_session_id.

pub fn seed_text_file( self, session_id: TypedId<SessionIdMarker>, path: impl Into<String>, content: impl Into<String>, ) -> InProcessRuntimeBuilder

Seed an additional text file directly into a session workspace.

This is applied after harness/agent/session initial_files are merged.

pub fn with_plugin_dir( self, path: &Path, ) -> Result<InProcessRuntimeBuilder, AgentLoopError>

Load a plugin from a local directory and make it available as a plugin:{name} capability.

Reads the plugin directory via PluginFileSet::from_dir and compiles it with compile_plugin at call time. A compilation failure is surfaced immediately as a configuration error so the problem is visible before the runtime is built. Non-fatal compilation warnings are logged via tracing::warn! and also collected so they can be inspected on the built runtime via InProcessRuntime::plugin_warnings.

After loading, agents and harnesses can reference the plugin by its plugin:{name} capability ref. The hydrated config carries the compiled DeclarativeCapabilityDefinition, which the core capability resolution path recognises without a registry entry (same path as declarative capabilities).

When using Self::single_session, call SingleSessionBuilder::agent_plugin to add the capability ref to the seeded agent, or use [AgentBuilder::capability] / with_capability directly.

pub fn plugin_capability(&self, name: &str) -> Option<AgentCapabilityConfig>

Return a hydrated AgentCapabilityConfig for a previously loaded plugin.

Returns None when no plugin with that name was loaded via Self::with_plugin_dir. Primarily used by callers that need the hydrated config to seed it onto a harness or agent before building.

pub async fn build(self) -> Result<InProcessRuntime, AgentLoopError>

Build the in-process runtime.

Returns a configuration error when no default model is available after applying explicit configuration and any requested llmsim setup.

Trait Implementations

impl Default for InProcessRuntimeBuilder

fn default() -> InProcessRuntimeBuilder

Returns the “default value” for a type.