vtcode-desktop-protocol 0.181.9

Versioned JSON-RPC protocol shared by VT Code desktop hosts
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

//! Native composer resource-discovery DTOs.

use serde::{Deserialize, Serialize};

/// A discoverable source for the native composer's Add menu.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub enum ComposerResourceKind {
    /// A CLI skill with an explicit dollar-name mention.
    Skill,
    /// An installed Agent Plugin.
    Plugin,
}

/// Bounded, non-secret discovery metadata; never executable content.
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct ComposerResource {
    /// Validated resource name.
    pub name: String,
    /// Short plain-text description.
    pub description: String,
    /// Which shared CLI discovery source owns this entry.
    pub kind: ComposerResourceKind,
}

impl ComposerResource {
    /// Resource names are safe single tokens for explicit CLI skill mentions.
    pub fn is_valid_name(name: &str) -> bool {
        !name.is_empty()
            && name.len() <= 128
            && name.bytes().all(|byte| byte.is_ascii_alphanumeric() || b"-_.".contains(&byte))
    }
}