Struct AppStateBuilder 

pub struct AppStateBuilder { /* private fields */ }

Builder for AppState.

This is the canonical manual-construction factory for runtime/session/client state when callers need a snapshot without going through full CLI bootstrap.

Use AppStateBuilder::from_resolved_config for the normal config-driven path, then override specific pieces such as the session or plugin manager as needed. Use AppStateBuilder::new only when the caller already has a fully chosen UiState and wants the builder to assemble the remaining runtime/session/client pieces around it.

Examples

use osp_cli::app::{AppSession, AppStateBuilder, RuntimeContext, TerminalKind};
use osp_cli::config::{ConfigLayer, ConfigResolver, ResolveOptions};

let mut defaults = ConfigLayer::default();
defaults.set("profile.default", "default");

let mut resolver = ConfigResolver::default();
resolver.set_defaults(defaults);
let config = resolver.resolve(ResolveOptions::new().with_terminal("repl")).unwrap();

let state = AppStateBuilder::from_resolved_config(
    RuntimeContext::new(None, TerminalKind::Repl, None),
    config,
)?
.with_session(AppSession::with_cache_limit(32).with_prompt_prefix("demo"))
.build();

assert_eq!(state.prompt_prefix(), "demo");

Implementations

impl AppStateBuilder

pub fn new(context: RuntimeContext, config: ResolvedConfig, ui: UiState) -> Self

Starts building an application-state snapshot from the resolved config and UI state the caller wants to expose.

This is the manual-construction path. Prefer AppStateBuilder::from_resolved_config when the builder should derive UI defaults from config and runtime context first.

pub fn from_resolved_config( context: RuntimeContext, config: ResolvedConfig, ) -> Result<Self>

Starts a builder by deriving UI state from the resolved config and runtime context.

This is the canonical embedder entrypoint when you want one coherent host snapshot and only plan to override selected pieces before build.

pub fn with_launch(self, launch: LaunchContext) -> Self

Replaces the launch-time provenance used for cache and plugin setup.

If omitted, the builder keeps LaunchContext::default.

pub fn with_plugins(self, plugins: PluginManager) -> Self

Replaces the plugin manager used when assembling shared clients.

If omitted, the builder derives the plugin manager from the resolved config plus the current launch context during AppStateBuilder::build.

pub fn with_native_commands( self, native_commands: NativeCommandRegistry, ) -> Self

Replaces the native command registry used when assembling shared clients.

If omitted, the builder keeps NativeCommandRegistry::default.

pub fn with_session(self, session: AppSession) -> Self

Replaces the session snapshot carried by the built app state.

If omitted, the builder uses the derived/default session for the current config.

pub fn build(self) -> AppState

Builds the configured AppState.

This assembles one coherent runtime/session/client snapshot, deriving any omitted pieces such as themes, plugin manager, and default session before returning the final value.