Struct AppContext 

pub struct AppContext<P: Platform> { /* private fields */ }

Fully initialized application context.

Holds all dependencies needed to run the agent loop. Created via AppContext::new and consumed via AppContext::into_agent_loop.

The generic parameter P is the platform implementation (e.g. NativePlatform for native, a WASM platform for browser environments).

Implementations

impl<P: Platform> AppContext<P>

pub async fn new(config: Config, platform: Arc<P>) -> Result<Self>

Initialize all components from configuration and platform.

This is the primary constructor. It:

1. Creates the MessageBus
2. Initializes the SessionManager (discovers/creates sessions dir)
3. Initializes the MemoryStore (discovers memory dir)
4. Initializes the SkillsLoader (discovers skills dir)
5. Creates the ContextBuilder
6. Creates an empty ToolRegistry (caller registers tools after)
7. Wires the default Level 0 pipeline (keyword classifier, static router, token budget assembler, stub transport, noop scorer, noop learner)

Errors

Returns [ClawftError] if the home directory cannot be determined or the sessions directory cannot be created.

pub fn into_agent_loop(self) -> AgentLoop<P>

Consume the context and produce a running AgentLoop.

All dependencies are moved into the agent loop. After this call, the AppContext is consumed and cannot be reused.

pub fn config(&self) -> &Config

Get a reference to the root configuration.

pub fn platform(&self) -> &Arc<P>

Get a reference to the platform.

pub fn bus(&self) -> &Arc<MessageBus>

Get a reference to the message bus.

Channel adapters should clone the inbound sender from here before the context is consumed by [into_agent_loop].

pub fn tools_mut(&mut self) -> &mut ToolRegistry

Get a mutable reference to the tool registry.

Call this to register tools before converting to an agent loop.

Panics

Panics if Arc clones have already been taken (e.g. via tools_arc()). Always call tools_mut() for registration before sharing the registry.

pub fn tools(&self) -> &Arc<ToolRegistry>

Get a reference to the tool registry.

pub fn tools_arc(&self) -> Arc<ToolRegistry>

Get a clone of the Arc<ToolRegistry> for sharing with other components.

pub fn sessions(&self) -> &Arc<SessionManager<P>>

Get a reference to the session manager.

pub fn memory(&self) -> &Arc<MemoryStore<P>>

Get a reference to the shared memory store.

pub fn skills(&self) -> &Arc<SkillsLoader<P>>

Get a reference to the shared skills loader.

pub fn set_auto_delegation(&mut self, delegation: Arc<dyn AutoDelegation>)

Set an auto-delegation router for pre-LLM routing.

When set, inbound messages are checked against delegation rules before the local LLM is invoked. Matching messages are routed directly to delegate_task.

pub fn set_pipeline(&mut self, pipeline: PipelineRegistry)

Replace the pipeline registry with a custom one.

Use this to inject a transport backed by a real LLM provider or to register specialized pipelines for specific task types.

pub fn enable_live_llm(&mut self)

Replace the pipeline with a live LLM-backed pipeline.

Convenience method that calls build_live_pipeline and sets it as the active pipeline, enabling real LLM calls through the clawft-llm provider resolved from configuration.

Only available with the native feature.