bitrouter-providers 0.33.0

BitRouter provider adapters — HTTP client, auth, streaming
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64

//! In-memory catalog entry for a discovered skill.

use std::path::PathBuf;

use bitrouter_core::routers::registry::SkillEntry;
use bitrouter_core::routers::registry::ToolEntry;
use bitrouter_core::tools::definition::ToolDefinition;

/// Internal representation of a skill in the in-memory catalog.
///
/// Built from scanning `SKILL.md` files on disk. Converts to [`SkillEntry`]
/// for the `SkillService` API and to [`ToolEntry`] for unified tool discovery.
#[derive(Debug, Clone)]
pub(crate) struct SkillCatalogEntry {
    /// Unique skill identifier (UUID string).
    pub id: String,
    /// Skill name from SKILL.md frontmatter.
    pub name: String,
    /// What the skill does and when to use it.
    pub description: String,
    /// How the skill was registered: `"filesystem"` or a remote URL.
    pub source: String,
    /// Provider names this skill depends on for paid API access.
    pub required_apis: Vec<String>,
    /// Absolute path to the SKILL.md file on disk.
    pub path: PathBuf,
    /// ISO 8601 timestamp.
    pub created_at: String,
    /// ISO 8601 timestamp.
    pub updated_at: String,
    /// Tool routing name this skill is bound to (from config).
    pub bound_tool: Option<String>,
}

impl SkillCatalogEntry {
    /// Convert to a [`SkillEntry`] for the skills CRUD API.
    pub fn to_skill_entry(&self) -> SkillEntry {
        SkillEntry {
            id: self.id.clone(),
            name: self.name.clone(),
            description: self.description.clone(),
            source: self.source.clone(),
            required_apis: self.required_apis.clone(),
            created_at: self.created_at.clone(),
            updated_at: self.updated_at.clone(),
            bound_tool: self.bound_tool.clone(),
        }
    }

    /// Convert to a [`ToolEntry`] for the unified tool discovery endpoint.
    pub fn to_tool_entry(&self) -> ToolEntry {
        ToolEntry {
            id: format!("skill/{}", self.name),
            provider: "skill".to_string(),
            definition: ToolDefinition {
                name: self.name.clone(),
                description: Some(self.description.clone()),
                input_schema: None,
                annotations: None,
                input_examples: Vec::new(),
            },
        }
    }
}