Skip to main content

Crate zeph_plugins

Crate zeph_plugins 

Source
Expand description

Plugin packaging and management for Zeph.

A plugin is a directory (local or remote git) containing:

  • plugin.toml — manifest describing the plugin (name, version, skills, MCP servers, config overlay)
  • one or more skill directories with SKILL.md files
  • optional MCP server declarations

Plugins are installed to ~/.local/share/zeph/plugins/<name>/ and loaded at agent startup.

§Security Model

  • Plugin config overlays are tighten-only: they can add to blocked_commands, narrow allowed_commands, or raise disambiguation_threshold — never loosen constraints.
  • Plugin MCP entries are validated against mcp.allowed_commands at install time.
  • .bundled markers are stripped recursively from all plugin skill trees.
  • Skill name conflicts with managed, bundled, or other plugin skills are hard-errors at install.

Re-exports§

pub use error::PluginError;
pub use manager::AddResult;
pub use manager::InstalledPlugin;
pub use manager::PluginManager;
pub use manager::RemoveResult;
pub use manifest::PluginManifest;
pub use overlay::ResolvedOverlay;
pub use overlay::apply_plugin_config_overlays;

Modules§

error
Error types for plugin operations.
manager
Plugin lifecycle management: add, remove, list.
manifest
plugin.toml manifest schema.
overlay
Plugin tighten-only config overlay merge.