Struct TmaiCore 

pub struct TmaiCore { /* private fields */ }

The Facade that wraps all tmai-core services.

Constructed via TmaiCoreBuilder.

Implementations

impl TmaiCore

pub fn approve(&self, target: &str) -> Result<(), ApiError>

Approve an agent action (send approval keys based on agent type).

Returns Ok(()) if approval was sent or the agent was already not awaiting.

pub fn select_choice(&self, target: &str, choice: usize) -> Result<(), ApiError>

Select a choice for a UserQuestion prompt.

choice is 1-indexed (1 = first option, N+1 = “Other”).

pub fn submit_selection( &self, target: &str, selected_choices: &[usize], ) -> Result<(), ApiError>

Submit multi-select choices (checkbox or legacy format).

selected_choices is a list of 1-indexed choice numbers.

pub async fn send_text(&self, target: &str, text: &str) -> Result<(), ApiError>

Send text input to an agent followed by Enter.

Includes a 50ms delay between text and Enter to prevent paste-burst issues.

pub fn send_key(&self, target: &str, key: &str) -> Result<(), ApiError>

Send a special key to an agent (whitelist-validated).

pub fn focus_pane(&self, target: &str) -> Result<(), ApiError>

Focus on a specific pane in tmux

pub fn kill_pane(&self, target: &str) -> Result<(), ApiError>

Kill a specific pane in tmux

impl TmaiCore

pub fn raw_state(&self) -> &SharedState

👎Deprecated: Use TmaiCore query/action methods instead of direct state access

Access the raw shared state.

Deprecated: prefer using typed query/action methods on TmaiCore. This escape hatch exists for incremental migration only.

pub fn raw_command_sender(&self) -> Option<&Arc<CommandSender>>

👎Deprecated: Use TmaiCore action methods instead of direct CommandSender access

Access the raw command sender.

Deprecated: prefer using action methods on TmaiCore. This escape hatch exists for incremental migration only.

pub fn settings(&self) -> &Settings

Access application settings (read-only)

pub fn ipc_server(&self) -> Option<&Arc<IpcServer>>

Access the IPC server (if configured)

impl TmaiCore

pub fn subscribe(&self) -> Receiver<CoreEvent>

Subscribe to core events.

Returns a broadcast receiver that will receive CoreEvents. If the receiver falls behind, older events are dropped (lagged).

pub fn notify_agents_updated(&self)

Notify subscribers that the agent list was updated.

Called by external consumers (e.g. TUI main loop) after processing PollMessage::AgentsUpdated. Ignored if no subscribers are listening.

pub fn notify_teams_updated(&self)

Notify subscribers that team data was updated.

Called by external consumers after team scan completes.

impl TmaiCore

pub fn list_agents(&self) -> Vec<AgentSnapshot>

List all monitored agents as owned snapshots, in current display order.

pub fn get_agent(&self, target: &str) -> Result<AgentSnapshot, ApiError>

Get a single agent snapshot by target ID.

pub fn selected_agent(&self) -> Result<AgentSnapshot, ApiError>

Get the currently selected agent snapshot.

pub fn attention_count(&self) -> usize

Get the number of agents that need user attention.

pub fn agent_count(&self) -> usize

Get the total number of monitored agents.

pub fn agents_needing_attention(&self) -> Vec<AgentSnapshot>

List agents that need attention (awaiting approval or error).

pub fn get_preview(&self, target: &str) -> Result<String, ApiError>

Get the ANSI preview content for an agent.

pub fn get_content(&self, target: &str) -> Result<String, ApiError>

Get the plain-text content for an agent.

pub fn list_teams(&self) -> Vec<TeamSummary>

List all known teams as owned summaries.

pub fn get_team(&self, name: &str) -> Result<TeamSummary, ApiError>

Get a single team summary by name.

pub fn get_team_tasks(&self, name: &str) -> Result<Vec<TeamTaskInfo>, ApiError>

Get tasks for a team.

pub fn is_running(&self) -> bool

Check if the application is still running.

pub fn last_poll(&self) -> Option<DateTime<Utc>>

Get the last poll timestamp.

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

Get known working directories from current agents.