Skip to main content

Module plugin

Module plugin 

Source
Expand description

In-process plugin host.

Loads .wasm plugins via Extism, validates their manifests, exposes the host-fn surface from the design spec (see docs/superpowers/specs/2026-05-18-hm-local-first-redesign-design.md §3.3).

Re-exports§

pub use host::LoadedPlugin;
pub use registry::PluginRegistry;
pub use registry::RegistryConfig;

Modules§

embedded
Embedded plugin bytes. Compiled by build.rs.
host
Thin wrapper around extism::Plugin instances loaded into a per-plugin pool. Concurrent invocations from chain tasks acquire a pool slot rather than blocking on a single plugin instance.
host_fns
All host functions exported to plugins. The exhaustive list lives in the design spec §3.3; this file is the single source of truth for which fn names exist and what types they accept.
install
Implementation of hm plugin install <source> --pin <sha256>.
manifest
Validates plugin manifests as they’re loaded.
paths
Filesystem locations the plugin host inspects.
pool
Instance pool for a loaded plugin.
registry
Discovers .wasm plugins under the user and project plugin dirs, validates each manifest, and builds a capability index used by the dispatcher.
signal
Bridges OS signals to the orchestrator’s CancellationToken.