roboticus-plugin-sdk
Version 0.9.x (tracks workspace releases; crate version is
0.9.9in-tree)
Plugin system for the Roboticus agent runtime. Provides the Plugin trait, TOML manifest parsing, script execution with declared-capability checks, plugin packaging (.ic.zip archives), remote catalog discovery, and a plugin registry with directory discovery and lifecycle management.
Key Types & Traits
| Type | Module | Description |
|---|---|---|
Plugin |
lib |
Async trait: name(), version(), tools(), init(), execute_tool(), shutdown() |
ToolDef |
lib |
Tool definition (name, description, JSON Schema parameters, risk level, permissions) |
ToolResult |
lib |
Tool execution result (success, output, metadata) |
PluginStatus |
lib |
Loaded / Active / Disabled / Error |
PluginManifest |
manifest |
TOML manifest parsing, validation, requirements, companion skills, per-tool parameters_schema |
PluginRegistry |
registry |
Plugin discovery, registration, and lifecycle |
PluginLoader |
loader |
Load plugins from directory with auto-discovery |
ScriptPlugin |
script |
Script-based plugin execution; default parameter schema requires prompt when manifest omits parameters_schema |
PackResult / UnpackResult |
archive |
Pack/unpack .ic.zip archives with SHA-256 verification |
PluginCatalog |
catalog |
Remote plugin catalog search and lookup |
Usage
[]
= "0.9"
use ;
// Implement the Plugin trait for custom plugins
Documentation
- Plugin Authoring Guide — Create, test, package, and distribute plugins
- API docs are available on docs.rs
License
Licensed under Apache-2.0. See LICENSE for details.