vtcode-core 0.147.2

Core library for VT Code - a Rust-based terminal coding agent
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
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92

//! Plugin system for VT Code
//!
//! This module provides a comprehensive plugin system that supports:
//! - Commands (slash commands)
//! - Agents (specialized profiles)
//! - Skills (model-invoked capabilities)
//! - Hooks (event handlers)
//! - MCP servers (Model Context Protocol)

pub mod caching;
pub mod components;
pub mod directory;
pub mod loader;
pub mod manager;
pub mod manifest;
pub mod runtime;
pub mod validation;

pub use caching::*;
pub use components::*;
pub use directory::*;
pub use loader::*;
pub use manager::*;
pub use manifest::*;
pub use runtime::*;
pub use validation::*;

crate::id_newtype::define_id_newtype! {
    /// Identifier for a plugin.
    pub struct PluginId
}

/// Type alias for plugin names
pub type PluginName = String;

/// Plugin loading result
pub type PluginResult<T> = Result<T, PluginError>;

pub(crate) fn validate_plugin_component(value: &str) -> PluginResult<()> {
    let mut components = std::path::Path::new(value).components();
    if value.trim().is_empty()
        || !matches!(components.next(), Some(std::path::Component::Normal(_)))
        || components.next().is_some()
    {
        return Err(PluginError::LoadingError(format!("Plugin name must be one normal path component: {value}")));
    }
    Ok(())
}

#[cfg(test)]
mod tests {
    // Intentionally empty test module for compilation check

    #[test]
    fn test_plugin_system_compilation() {
        // This test just verifies that the plugin system compiles
    }
}

/// Plugin error types
#[derive(Debug, thiserror::Error)]
pub enum PluginError {
    #[error("Plugin manifest validation failed: {0}")]
    ManifestValidationError(String),

    #[error("Plugin not found: {0}")]
    NotFound(PluginId),

    #[error("Plugin already exists: {0}")]
    AlreadyExists(PluginId),

    #[error("Plugin loading failed: {0}")]
    LoadingError(String),

    #[error("Plugin execution failed: {0}")]
    ExecutionError(String),

    #[error("Plugin permission denied: {0}")]
    PermissionDenied(String),

    #[error("Plugin configuration error: {0}")]
    ConfigurationError(String),

    #[error("I/O error: {0}")]
    IoError(#[from] std::io::Error),

    #[error("JSON serialization error: {0}")]
    JsonError(#[from] serde_json::Error),

    #[error("TOML serialization error: {0}")]
    TomlError(#[from] toml::de::Error),
}