Struct ProcessStatus 

pub struct ProcessStatus {
    pub block_id: String,
    pub lifecycle: Lifecycle,
    pub processes: Vec<TrackedProcess>,
    pub liveness_confidence: TrackingConfidence,
    pub controller_type: String,
    pub is_agent_pane: bool,
    pub last_computed_ms: u64,
    pub controller_status: Option<BlockControllerRuntimeStatus>,
}

The broker’s public read shape — one struct every consumer (Agent pane, Swarm pane, future consumers) reads instead of composing raw registry data themselves.

Fields

block_id: String

lifecycle: Lifecycle

processes: Vec<TrackedProcess>

OS-process-tree detail — empty for controller types process_tracker doesn’t cover yet (today: shell, acp; report §1/§5.2). Presence of entries here is opportunistic enrichment, not a liveness signal on its own — use lifecycle, not !processes.is_empty(), to answer “is it alive.”

liveness_confidence: TrackingConfidence

controller_type: String

Controller type string ("shell", "cmd", "subprocess", "persistent", "acp", "app-server") — see is_agent() for why this matters beyond being informational.

is_agent_pane: bool

last_computed_ms: u64

controller_status: Option<BlockControllerRuntimeStatus>

The raw BlockControllerRuntimeStatus compute_status already reads to derive lifecycle/is_agent_pane above — exposed so callers that want the finer-grained fields (shellprocstatus, spawn_ts_ms, turn_active itself, not just the lifecycle it was folded into) don’t have to read the controller registry a second time and risk a second, possibly-inconsistent snapshot (codex P2 on PR #2380 — the muxspect describe route originally did exactly that).

Implementations

impl ProcessStatus

fn unknown(block_id: &str) -> Self

pub fn is_agent(&self) -> bool

True if this block is an agent pane rather than a plain terminal.

is_agent_pane alone is NOT sufficient: subprocess/persistent/ acp controllers exist only for agent CLIs (one-shot-per-turn, long-lived stream-json, and JSON-RPC/ACP agents respectively — see blockcontroller/mod.rs’s controller-type doc), but SubprocessController unconditionally reports is_agent_pane: false in its runtime status regardless (reagent/codex P1 on #2273 — filtering on the flag alone would wrongly exclude every subprocess-type agent pane). Only shell/cmd controllers can legitimately be either a plain terminal or an agent running inside one, so is_agent_pane (set dynamically at PTY spawn time — see shell/lifecycle.rs) is the correct signal for exactly those two types, and only those two.

Trait Implementations

impl Clone for ProcessStatus

fn clone(&self) -> ProcessStatus

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ProcessStatus

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Serialize for ProcessStatus

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl TS for ProcessStatus

type WithoutGenerics = ProcessStatus

If this type does not have generic parameters, then WithoutGenerics should just be Self. If the type does have generic parameters, then all generic parameters must be replaced with a dummy type, e.g ts_rs::Dummy or ().
The only requirement for these dummy types is that EXPORT_TO must be None.

type OptionInnerType = ProcessStatus

If the implementing type is std::option::Option<T>, then this associated type is set to T. All other implementations of TS should set this type to Self instead.

fn ident(cfg: &Config) -> String

Identifier of this type, excluding generic parameters.

fn docs() -> Option<String>

JSDoc comment to describe this type in TypeScript - when TS is derived, docs are automatically read from your doc comments or #[doc = ".."] attributes

fn name(cfg: &Config) -> String

Name of this type in TypeScript, including generic parameters

fn decl_concrete(cfg: &Config) -> String

Declaration of this type using the supplied generic arguments. The resulting TypeScript definition will not be generic. For that, see TS::decl(). If this type is not generic, then this function is equivalent to TS::decl().

fn decl(cfg: &Config) -> String

Declaration of this type, e.g. type User = { user_id: number, ... }. This function will panic if the type has no declaration.

fn inline(cfg: &Config) -> String

Formats this types definition in TypeScript, e.g { user_id: number }. This function will panic if the type cannot be inlined.

fn inline_flattened(cfg: &Config) -> String

Flatten a type declaration. This function will panic if the type cannot be flattened.

fn visit_generics(v: &mut impl TypeVisitor)

where Self: 'static,

Iterates over all type parameters of this type.

fn output_path() -> Option<PathBuf>

Returns the output path to where T should be exported, relative to the output directory. The returned path does not include any base directory.

fn visit_dependencies(v: &mut impl TypeVisitor)

where Self: 'static,

Iterates over all dependency of this type.

fn dependencies(cfg: &Config) -> Vec<Dependency>

where Self: 'static,

Resolves all dependencies of this type recursively.

fn export(cfg: &Config) -> Result<(), ExportError>

where Self: 'static,

Manually export this type to the filesystem. To export this type together with all of its dependencies, use [TS::export_all].

fn export_all(cfg: &Config) -> Result<(), ExportError>

where Self: 'static,

Manually export this type to the filesystem, together with all of its dependencies. To export only this type, without its dependencies, use [TS::export].

fn export_to_string(cfg: &Config) -> Result<String, ExportError>

where Self: 'static,

Manually generate bindings for this type, returning a String. This function does not format the output, even if the format feature is enabled.