Struct ExtensionManifest 

pub struct ExtensionManifest {
    pub protocol_version: u32,
    pub runtime: ExtensionRuntime,
    pub command: String,
    pub setup: Option<String>,
    pub prebuilt: HashMap<String, PrebuiltAsset>,
    pub args: Vec<String>,
    pub permissions: Vec<String>,
    pub hooks: Vec<HookSubscription>,
    pub config: Vec<ExtensionConfigEntry>,
    pub theme_tokens: BTreeMap<String, String>,
    pub deferred: Option<DeferredDeclarations>,
}

Extension declaration inside a plugin manifest.

Deserialization goes through [RawExtensionManifest] so legacy manifest aliases (extension.tools + activation: "deferred", the pre-native shape shipped by early deferred plugins such as axel-memory-manager 0.1) are folded into the native deferred block BEFORE any classification or validation can observe them. Unknown activation values fail closed instead of silently loading eager.

Fields

protocol_version: u32

Extension protocol version. Defaults to v1 for pre-versioned manifests.

runtime: ExtensionRuntime

Runtime type (only “process” in phase 1).

command: String

Command to start the extension process.

setup: Option<String>

Optional path to a post-install setup script (relative to plugin root). When present, the marketplace install flow runs this script after the plugin source is in place — used by source-shipped extensions (e.g. Rust binaries) that need to compile a binary before Self::command resolves. Same security model as provides.sidecar.setup (path must stay inside the plugin dir; see crate::skills::post_install for the runner).

prebuilt: HashMap<String, PrebuiltAsset>

Optional per-host-triple prebuilt asset map. When the installer can’t find Self::command on disk after the source clone, it looks up the current host’s triple (e.g. linux-x86_64, darwin-arm64, windows-x86_64 — see crate::skills::post_install::host_triple) in this map and, if a matching PrebuiltAsset exists, downloads and extracts it into the plugin dir as a fast path that skips Self::setup. Empty by default.

args: Vec<String>

Arguments to pass to the command.

permissions: Vec<String>

Permissions requested by the extension.

hooks: Vec<HookSubscription>

Hooks the extension wants to subscribe to.

config: Vec<ExtensionConfigEntry>

Non-secret config declarations resolved by Synaps and passed to initialize.

theme_tokens: BTreeMap<String, String>

OPTIONAL (additive, protocol v1-compatible per docs/STABILITY.md §1): theme tokens this extension declares, merged by the TUI into the active theme under the ext.<plugin-id>.<token> namespace at load. Keys are token names (no dots/slashes/spaces); values are hex colors (#rgb or #rrggbb). A user theme-TOML key ext.<plugin-id>.<token> always overrides the manifest value. Absent => empty map => behavior identical to pre-P19.2 manifests.

deferred: Option<DeferredDeclarations>

OPTIONAL (additive, protocol v1-compatible): passive deferred lifecycle declarations (Task 20, spec 7.5). Absent => legacy eager lifecycle, byte-for-byte compatible. Present declarations are trusted local manifest expectations validated BEFORE any spawn and matched EXACTLY against runtime initialize declarations.

Implementations

impl ExtensionManifest

pub fn validate(&self, id: &str) -> Result<ValidatedExtensionManifest, String>

Validate manifest fields and derive typed permissions/subscriptions.

Trait Implementations

impl Clone for ExtensionManifest

fn clone(&self) -> ExtensionManifest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ExtensionManifest

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ExtensionManifest

fn deserialize<__D>( __deserializer: __D, ) -> Result<ExtensionManifest, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ExtensionManifest

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl TryFrom<RawExtensionManifest> for ExtensionManifest

type Error = String

The type returned in the event of a conversion error.

fn try_from( raw: RawExtensionManifest, ) -> Result<ExtensionManifest, <ExtensionManifest as TryFrom<RawExtensionManifest>>::Error>

Performs the conversion.