opencode_rs 0.7.0

Rust SDK for OpenCode (HTTP-first hybrid with SSE 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
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

//! Skill types for `opencode_rs`.
//!
//! Types for skills (reusable prompt templates/workflows).

use serde::Deserialize;
use serde::Serialize;

/// A skill definition.
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct SkillInfo {
    /// Skill identifier/name.
    pub name: String,

    /// Skill description.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub description: Option<String>,

    /// Skill file path.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub path: Option<String>,

    /// Whether this is a built-in skill.
    #[serde(default)]
    pub builtin: bool,

    /// Skill content/template.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub content: Option<String>,

    /// Additional fields from server.
    #[serde(flatten)]
    pub extra: serde_json::Value,
}

/// Response for skill directories.
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct SkillDirs {
    /// List of directories containing skills.
    #[serde(default)]
    pub dirs: Vec<String>,

    /// Additional fields from server.
    #[serde(flatten)]
    pub extra: serde_json::Value,
}

/// Request to get a specific skill.
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct SkillGetRequest {
    /// Skill name to retrieve.
    pub name: String,
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_skill_info_minimal() {
        let json = r#"{"name": "code-review"}"#;
        let skill: SkillInfo = serde_json::from_str(json).unwrap();
        assert_eq!(skill.name, "code-review");
        assert!(skill.description.is_none());
        assert!(!skill.builtin);
    }

    #[test]
    fn test_skill_info_full() {
        let json = r#"{
            "name": "code-review",
            "description": "Review code for issues",
            "path": "/skills/code-review.md",
            "builtin": true,
            "content": "Please review the following code..."
        }"#;
        let skill: SkillInfo = serde_json::from_str(json).unwrap();
        assert_eq!(skill.name, "code-review");
        assert_eq!(
            skill.description,
            Some("Review code for issues".to_string())
        );
        assert_eq!(skill.path, Some("/skills/code-review.md".to_string()));
        assert!(skill.builtin);
        assert!(skill.content.is_some());
    }

    #[test]
    fn test_skill_dirs() {
        let json = r#"{"dirs": ["/project/.opencode/skills", "/home/user/.opencode/skills"]}"#;
        let dirs: SkillDirs = serde_json::from_str(json).unwrap();
        assert_eq!(dirs.dirs.len(), 2);
    }

    #[test]
    fn test_skill_extra_fields_preserved() {
        let json = r#"{
            "name": "test-skill",
            "futureField": "value"
        }"#;
        let skill: SkillInfo = serde_json::from_str(json).unwrap();
        assert_eq!(skill.extra["futureField"], "value");
    }
}