zeptoclaw 0.9.0

Ultra-lightweight personal AI assistant
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
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
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128

//! Skills type definitions.

use serde::{Deserialize, Serialize};

/// Loaded skill model.
#[derive(Debug, Clone)]
pub struct Skill {
    /// Skill name.
    pub name: String,
    /// Short description.
    pub description: String,
    /// Absolute path to `SKILL.md`.
    pub path: String,
    /// Source type: `workspace` or `builtin`.
    pub source: String,
    /// Parsed frontmatter metadata.
    pub metadata: SkillMetadata,
    /// Markdown body content.
    pub content: String,
}

/// Skill listing entry.
#[derive(Debug, Clone)]
pub struct SkillInfo {
    /// Skill name.
    pub name: String,
    /// Skill file path.
    pub path: String,
    /// Source type: `workspace` or `builtin`.
    pub source: String,
}

fn default_required() -> bool {
    true
}

/// A required/optional environment variable declared by a skill.
#[derive(Debug, Clone, Default, Serialize, Deserialize)]
#[serde(default)]
pub struct EnvSpec {
    /// Environment variable name (e.g. "WHATSAPP_PHONE_NUMBER_ID").
    pub name: String,
    /// Human-readable description shown in `skills show`.
    pub description: String,
    /// Whether this env var is required (default: true).
    #[serde(default = "default_required")]
    pub required: bool,
}

/// Parsed frontmatter metadata.
#[derive(Debug, Clone, Default, Serialize, Deserialize)]
#[serde(default)]
pub struct SkillMetadata {
    /// Skill name.
    pub name: String,
    /// Skill description.
    pub description: String,
    /// Optional version (semver).
    pub version: Option<String>,
    /// Optional homepage URL.
    pub homepage: Option<String>,
    /// Skill author name.
    pub author: Option<String>,
    /// Skill license identifier (e.g. "MIT").
    pub license: Option<String>,
    /// Categorization tags (e.g. ["messaging", "sea"]).
    #[serde(default)]
    pub tags: Vec<String>,
    /// Skill names that must be present for this skill to be available.
    #[serde(default)]
    pub depends: Vec<String>,
    /// Skill names that conflict with this skill.
    #[serde(default)]
    pub conflicts: Vec<String>,
    /// Environment variables needed by this skill (informational + gating).
    #[serde(default)]
    pub env_needed: Vec<EnvSpec>,
    /// ZeptoClaw metadata payload.
    pub metadata: Option<serde_json::Value>,
}

/// ZeptoClaw metadata extension.
/// Compatible with both `metadata.zeptoclaw` and `metadata.openclaw` namespaces.
#[derive(Debug, Clone, Default, Serialize, Deserialize)]
#[serde(default)]
pub struct ZeptoMetadata {
    /// Optional emoji for UI and summaries.
    pub emoji: Option<String>,
    /// Runtime requirements.
    pub requires: SkillRequirements,
    /// Suggested install options.
    pub install: Vec<InstallOption>,
    /// Whether to always inject this skill into context.
    pub always: bool,
    /// Platform filter (e.g. `["darwin", "linux", "win32"]`). Empty means all platforms.
    pub os: Vec<String>,
}

/// Requirement model for a skill.
#[derive(Debug, Clone, Default, Serialize, Deserialize)]
#[serde(default)]
pub struct SkillRequirements {
    /// Required binaries in `PATH` (all must be present).
    pub bins: Vec<String>,
    /// At least one of these binaries must be in `PATH` (OpenClaw compat).
    #[serde(default, alias = "anyBins")]
    pub any_bins: Vec<String>,
    /// Required environment variables.
    pub env: Vec<String>,
}

/// Install option metadata.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct InstallOption {
    /// Option identifier.
    pub id: String,
    /// Install kind (`brew`, `apt`, `cargo`, ...).
    pub kind: String,
    /// Optional formula.
    pub formula: Option<String>,
    /// Optional package name.
    pub package: Option<String>,
    /// Binaries expected after install.
    #[serde(default)]
    pub bins: Vec<String>,
    /// User-facing label.
    pub label: String,
}