cc-agent-sdk 0.1.7

claude agent sdk
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

//! Error types for the Skills system

use std::fmt;
use thiserror::Error;

/// Errors that can occur in the Skills system
#[derive(Error, Debug, Clone)]
pub enum SkillError {
    /// Validation error
    #[error("Skill validation failed: {0}")]
    Validation(String),

    /// Execution error
    #[error("Skill execution failed: {0}")]
    Execution(String),

    /// IO error
    #[error("IO error: {0}")]
    Io(String),

    /// Serialization error
    #[error("Serialization error: {0}")]
    Serialization(String),

    /// Skill not found
    #[error("Skill not found: {0}")]
    NotFound(String),

    /// Skill already exists
    #[error("Skill already exists: {0}")]
    AlreadyExists(String),

    /// Invalid skill metadata
    #[error("Invalid skill metadata: {0}")]
    InvalidMetadata(String),

    /// Skill version conflict
    #[error("Skill version conflict: {0}")]
    VersionConflict(String),

    /// Configuration error
    #[error("Configuration error: {0}")]
    Configuration(String),
}

/// Result type for Skill operations
pub type Result<T> = std::result::Result<T, SkillError>;

/// Result of a Skill execution
#[derive(Debug, Clone, serde::Serialize, serde::Deserialize)]
pub struct SkillOutput {
    /// Whether execution was successful
    pub success: bool,

    /// Output data
    pub data: serde_json::Value,

    /// Error message if failed
    #[serde(skip_serializing_if = "Option::is_none")]
    pub error: Option<String>,

    /// Additional metadata
    #[serde(skip_serializing_if = "Option::is_none")]
    pub metadata: Option<serde_json::Value>,
}

impl SkillOutput {
    /// Create a successful output
    pub fn ok(data: impl Into<serde_json::Value>) -> Self {
        SkillOutput {
            success: true,
            data: data.into(),
            error: None,
            metadata: None,
        }
    }

    /// Create a failed output
    pub fn err(error: impl Into<String>) -> Self {
        SkillOutput {
            success: false,
            data: serde_json::Value::Null,
            error: Some(error.into()),
            metadata: None,
        }
    }

    /// Add metadata to the output
    pub fn with_metadata(mut self, metadata: serde_json::Value) -> Self {
        self.metadata = Some(metadata);
        self
    }
}

impl fmt::Display for SkillOutput {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        if self.success {
            write!(f, "Success: {}", self.data)
        } else {
            write!(
                f,
                "Error: {}",
                self.error.as_deref().unwrap_or("Unknown error")
            )
        }
    }
}

/// Convenience type for Skill execution results
pub type SkillResult = Result<SkillOutput>;