Struct SkillManager 

pub struct SkillManager { /* private fields */ }

Shared skill catalog and optional delegated workers. All published views share one registry generation; a retained metadata snapshot never authorizes a later read.

Implementations

impl SkillManager

pub const NAME: &'static str = "skills_manager"

Existing compatibility tool name.

pub fn new(skills_dir: PathBuf) -> Self

Create an empty manager with one trusted discovery root.

pub fn new_with_dirs( default_skills_dir: PathBuf, additional_skills_dirs: Vec<PathBuf>, ) -> Self

Configure roots in priority order. The default root is also the suggested creation root. Relative roots are anchored to the process working directory at construction time.

pub fn default_skills_dir(&self) -> &Path

Directory suggested to skill creation workflows.

pub fn skills_dirs(&self) -> &[PathBuf]

Configured roots in priority order.

pub fn with_description(self, description: String) -> Self

Override the tool’s introductory description; the bounded catalog is still appended.

pub fn with_default_skill_tools(self, tools: Vec<String>) -> Self

Default tools for delegated skills that omit allowed-tools. An explicitly empty list grants none. Granting tools_select also permits subsequent discovery under runner rules.

pub fn with_limits(self, limits: SkillLimits) -> Self

Configure resource limits. Hard ceilings are depth 32, 20,000 directories, 100,000 entries, 4,096 skills, 128 MiB combined content, 64 KiB catalog and 512 KiB responses. Counts and total content have a minimum of one; catalog/response minima are 128/1,024 bytes.

pub fn tools(self: &Arc<Self>) -> Result<ToolSet<BaseCtx>, BoxError>

Register all three static local tools over this manager’s shared state.

pub fn invalidate(&self)

Invalidate membership after a filesystem or host configuration change. No I/O is done here.

pub fn set_skill_filter(&self, filter: Option<SkillFilter>)

Replace the host admission policy and immediately remove rejected identities. Newly admitted files are discovered on the next async access or explicit reload.

pub fn catalog(&self) -> Arc<SkillCatalogSnapshot>

Last published immutable metadata and diagnostics, without filesystem I/O.

pub async fn load(&self) -> Result<(), BoxError>

Compatibility reload API. Inspect Self::catalog for per-file failures and truncation.

pub async fn reload(&self) -> Result<SkillLoadReport, BoxError>

Rescan and publish all roots atomically. Missing roots become empty; invalid or unreadable files are omitted with diagnostics. No stale entries survive a successful publication.

pub fn get_skill(&self, lowercase_name: &str) -> Option<Skill>

Retrieve the winning skill by its normalized callable name, without I/O.

pub fn subagents(&self) -> Vec<SubAgent>

All unambiguous delegated workers, including explicit-only skills, for host inspection.

pub fn list(&self) -> BTreeMap<String, Skill>

Compatibility view of unambiguous winning skills, keyed by normalized callable name.

Trait Implementations

impl SubAgentSet for SkillManager

fn into_any(self: Arc<Self>) -> Arc<dyn Any + Send + Sync>

Converts the registry into Any for downcasting.

fn contains_lowercase(&self, name: &str) -> bool

Checks if a subagent with the given lowercase name exists.

fn get_lowercase(&self, name: &str) -> Option<SubAgent>

Retrieves a subagent by lowercase name.

fn definitions(&self, names: Option<&[String]>) -> Vec<FunctionDefinition>

Returns definitions for all or specified agents.

fn select_resources( &self, name: &str, resources: &mut Vec<Resource>, ) -> Vec<Resource>

Selects and returns resources relevant to the specified subagent name from the provided list.

impl Tool<BaseCtx> for SkillManager

type Args = SkillArgs

The arguments type of the tool.

type Output = SkillContentOutput

The output type of the tool.

fn name(&self) -> String

Returns the unique tool name.

fn description(&self) -> String

Returns a concise description of the tool’s capability.

fn definition(&self) -> FunctionDefinition

Returns the function definition, including the JSON parameter schema.

fn group(&self) -> Option<ToolGroupInfo>

Returns the capability group this tool belongs to, if any.

async fn call( &self, ctx: BaseCtx, args: Self::Args, _resources: Vec<Resource>, ) -> Result<ToolOutput<Self::Output>, BoxError>

Executes the tool with typed arguments and selected resources.

fn supported_resource_tags(&self) -> Vec<String>

Returns resource tags this tool can consume.

fn select_resources(&self, resources: &mut Vec<Resource>) -> Vec<Resource>

Removes and returns resources matching this tool’s supported tags.

fn init( &self, _ctx: C, ) -> impl Future<Output = Result<(), Box<dyn Error + Send + Sync>>> + Send

Initializes the tool with the given context.

fn call_raw( &self, ctx: C, args: Value, resources: Vec<Resource>, ) -> impl Future<Output = Result<ToolOutput<Value>, Box<dyn Error + Send + Sync>>> + Send

Executes the tool from raw JSON arguments and returns JSON output.