Struct App 

pub struct App { /* private fields */ }

Application state and entry point.

Holds an Oxi engine (composition root) and a single Agent built from it. The legacy App::new(settings) constructor is gone; use App::from_oxi with a wired Oxi from build_oxi_engine.

Implementations

impl App

pub async fn from_oxi( oxi: Oxi, settings: Settings, ownership_session_id: String, ) -> Result<Self>

Build an App from a wired Oxi engine and a settings object.

The Oxi should be created via build_oxi_engine (or services::build_oxi) so that all 11 ports are wired. The settings hold the user’s runtime configuration (model, thinking level, etc.).

ownership_session_id is the per-process liveness identity used by the agent’s issue tool (ToolContext.session_id), the TUI panel, and the /issue slash command. In TUI mode this MUST equal crate::store::issues::liveness::TUI_OWNERSHIP_ID so the panel and agent see the same flock holder. In print / RPC mode, a stable process-scoped id (e.g. proc-<pid>-<uuid>) is appropriate. When issue_store is available, an flock is acquired under this id for the lifetime of the returned App.

pub fn ownership_session_id(&self) -> &str

Per-process liveness identity. Used by the agent’s issue tool and any other surface that gates on is_session_alive.

pub fn has_liveness_lock(&self) -> bool

True iff App holds a live liveness flock under ownership_session_id. False when there is no issue_store (e.g. headless test) or when another live process already holds the lock (the assignment feature will surface Assigned errors in that case — by design).

pub fn settings(&self) -> &Settings

Get the current settings

pub fn set_wasm_ext(&mut self, ext: Option<Arc<WasmExtensionManager>>)

Set the WASM extension manager

pub fn wasm_ext(&self) -> Option<&Arc<WasmExtensionManager>>

Get the WASM extension manager

pub fn issue_store(&self) -> Option<FileIssueStore>

Get a clone of the local issue store, if one was opened successfully.

pub fn oxi(&self) -> &Oxi

Get a reference to the underlying Oxi engine. The catalog port and other ports are accessible through it.

pub fn agent(&self) -> Arc<Agent>

Get a reference to the underlying agent.

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

Get the tool registry (for registering extension tools)

pub fn questionnaire_bridge(&self) -> Option<&Arc<QuestionnaireBridge>>

Get the questionnaire bridge, if initialized.

pub fn skills(&self) -> RwLockReadGuard<'_, SkillManager>

Get a reference to the skill manager

pub fn activate_skill(&self, name: &str) -> Result<(), String>

Activate a skill by name. Returns an error string if not found.

pub fn deactivate_skill(&self, name: &str)

Deactivate a skill by name.

pub fn active_skills(&self) -> Vec<String>

List currently active skill names

pub fn agent_state(&self) -> AgentState

Get a clone of the current state

pub async fn run_prompt(&self, prompt: String) -> Result<String>

Run a single prompt and return the response

pub async fn run_prompt_with_events<F>( &self, prompt: String, on_event: F, ) -> Result<String>

where F: FnMut(AgentEvent) + Send + 'static,

Run a prompt with event callback

pub fn reset(&self)

Reset the conversation

pub async fn switch_model(&self, model_id: &str) -> Result<()>

Switch the model used for future LLM calls.

pub fn model_id(&self) -> String

Get the current model ID