Struct AddonInstall 

pub struct AddonInstall {
    pub manager: String,
    pub package: String,
    pub version: String,
    pub bin: String,
    pub verify: Vec<String>,
}

The [install] block — how addon add provisions the addon’s upstream package before wiring its [mcp] server. Absent (all-empty) ⇒ the addon is either an ephemeral runner (npx/uvx, installs lazily on first spawn) or already on the host; no bootstrap runs.

Fields

manager: String

Package manager: uv | pip | cargo | npm | brew | dotnet.

package: String

Package/formula to install (may carry extras, e.g. headroom-ai[all]).

version: String

Exact pinned version (mandatory; floating/latest is rejected).

bin: String

Executable the install provides — the [mcp].command. Used for the idempotency check (skip if already on PATH). Defaults to the package name.

verify: Vec<String>

Optional explicit “is it installed?” probe (argv; exit 0 ⇒ installed). Overrides the default PATH check; never run through a shell.

Implementations

impl AddonInstall

pub fn is_declared(&self) -> bool

true when the block actually requests a bootstrap install.

pub fn is_absent(&self) -> bool

Inverse of Self::is_declared — for #[serde(skip_serializing_if)].

pub fn manager(&self) -> Option<Manager>

The parsed manager, if declared and supported.

pub fn bin(&self) -> &str

The executable name to probe on PATH — explicit bin, else the package base name (extras + version stripped).

pub fn validate(&self) -> Result<(), String>

Validate the block: known manager, non-empty package, an exact pin, and no shell metacharacters anywhere (defence-in-depth). A no-op when absent.

pub fn to_receipt(&self) -> InstallReceipt

A receipt recording exactly what was installed, for a clean uninstall.

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

The exact install argv (for the disclosure preview). Empty if unsupported.

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

The exact uninstall argv (for the disclosure preview). Empty if unsupported.

Trait Implementations

impl Clone for AddonInstall

fn clone(&self) -> AddonInstall

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AddonInstall

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

Formats the value using the given formatter.

impl Default for AddonInstall

fn default() -> AddonInstall

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for AddonInstall

where AddonInstall: Default,

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for AddonInstall

impl PartialEq for AddonInstall

fn eq(&self, other: &AddonInstall) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for AddonInstall

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for AddonInstall