entelix-tools 0.5.4

//! In-memory skill plus the three LLM-facing tools that drive
//! progressive disclosure.
//!
//! ## Skills
//!
//! - [`InMemorySkill`] — struct holding name, description, version,
//!   instructions, and a resource map. Build via
//!   [`InMemorySkillBuilder`].
//!
//! Filesystem-backed skills (Anthropic Claude Skills `SKILL.md`
//! layout) live in the `entelix-tools-coding` companion crate
//! because their IO routes through `Sandbox` and they're a
//! coding-agent-vertical concern (invariant 9 boundary).
//!
//! ## LLM-facing tools
//!
//! - [`ListSkillsTool`] — argument-less listing of registered skills
//!   (T1 metadata).
//! - [`ActivateSkillTool`] — load a skill's instructions and resource
//!   menu (T1 → T2).
//! - [`ReadSkillResourceTool`] — fetch one resource by key (T2 → T3).
//!   Binary resources surface as metadata only (`mime_type`,
//!   `size_bytes`, `sha256`); the bytes are accessible via the
//!   `SkillRegistry` API for out-of-band host-application use.

mod in_memory;
mod tools;

use std::sync::Arc;

use entelix_core::error::Result;
use entelix_core::skills::SkillRegistry;
use entelix_core::tools::ToolRegistry;

pub use in_memory::{InMemorySkill, InMemorySkillBuilder, StaticResource};
pub use tools::{ActivateSkillTool, ListSkillsTool, ReadSkillResourceTool};

/// Register the three LLM-facing skill tools (`list_skills`,
/// `activate_skill`, `read_skill_resource`) into a `ToolRegistry`,
/// each backed by the supplied `SkillRegistry`.
///
/// Recipes that accept both a `ToolRegistry` and a `SkillRegistry`
/// call this helper to surface the skills to the model — the agent
/// runtime itself does not auto-wire ( §"Sub-agent
/// filtering"; the per-recipe call is the explicit opt-in).
///
/// Returns `Error::Config` from the underlying `ToolRegistry::register`
/// if any of the three names already collides — recipes typically
/// build a fresh registry, so the collision path indicates a
/// programmer error.
pub fn install(tool_registry: ToolRegistry, skill_registry: SkillRegistry) -> Result<ToolRegistry> {
    tool_registry
        .register(Arc::new(ListSkillsTool::new(skill_registry.clone())))?
        .register(Arc::new(ActivateSkillTool::new(skill_registry.clone())))?
        .register(Arc::new(ReadSkillResourceTool::new(skill_registry)))
}