acosmi-sdk 6.0.0

Acosmi Rust SDK:模型网关、Agent Run Gateway 与 Compliance 统一客户端。双格式(Anthropic + OpenAI)。端口自 acosmi-sdk-ts。
Documentation
//! 技能商店 / 技能生产器 / 统一工具域类型。
//!
//! 端口自 `skills/types.ts`(其端口自 `acosmi-sdk-go/types.go` v0.19.0)。
//!
//! 命名约定:字段名 = Go json tag 字面量(wire format),不做 camelCase 重映射。

use serde::{Deserialize, Serialize};

// =============================================================================
// Skill Store
// =============================================================================

/// 技能商店完整条目(Detail / resolve / browse 全量返回)。
#[derive(Debug, Clone, Default, Serialize, Deserialize)]
pub struct SkillStoreItem {
    pub id: String,
    #[serde(rename = "pluginId")]
    pub plugin_id: String,
    pub key: String,
    pub name: String,
    pub description: String,
    pub icon: String,
    pub category: String,
    #[serde(rename = "inputSchema")]
    pub input_schema: String,
    #[serde(rename = "outputSchema")]
    pub output_schema: String,
    pub timeout: i64,
    #[serde(rename = "retryCount")]
    pub retry_count: i64,
    #[serde(rename = "retryDelay")]
    pub retry_delay: i64,
    pub version: String,
    #[serde(rename = "totalCalls")]
    pub total_calls: i64,
    #[serde(rename = "avgDurationMs")]
    pub avg_duration_ms: i64,
    #[serde(rename = "successRate")]
    pub success_rate: f64,
    #[serde(rename = "isEnabled")]
    pub is_enabled: bool,
    #[serde(rename = "securityLevel")]
    pub security_level: String,
    #[serde(rename = "securityScore")]
    pub security_score: i64,
    pub scope: String,
    pub status: String,
    #[serde(rename = "downloadCount")]
    pub download_count: i64,
    /// 网关 `json:"readme,omitempty"`,空时缺字段,故可选。
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub readme: Option<String>,
    /// SKILL.md(Anthropic 标准格式);网关 `json:"skillMd,omitempty"`,仅 Detail/resolve/browse 全量返回。
    #[serde(rename = "skillMd", default, skip_serializing_if = "Option::is_none")]
    pub skill_md: Option<String>,
    pub tags: Vec<String>,
    pub author: String,
    #[serde(rename = "publisherId")]
    pub publisher_id: String,
    #[serde(rename = "isPublished")]
    pub is_published: bool,
    #[serde(rename = "pluginName")]
    pub plugin_name: String,
    #[serde(rename = "pluginIcon")]
    pub plugin_icon: String,
    #[serde(rename = "updatedAt")]
    pub updated_at: String,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub visibility: Option<String>,
    #[serde(
        rename = "certificationStatus",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub certification_status: Option<String>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub source: Option<String>,
}

/// 技能商店搜索参数(非 wire 类型,用于 client 方法参数)。
#[derive(Debug, Clone, Default)]
pub struct SkillStoreQuery {
    pub category: Option<String>,
    pub keyword: Option<String>,
    pub tag: Option<String>,
}

/// 技能统计概览。
#[derive(Debug, Clone, Default, Serialize, Deserialize)]
pub struct SkillSummary {
    pub installed: i64,
    pub created: i64,
    pub total: i64,
    #[serde(rename = "storeAvailable")]
    pub store_available: i64,
}

/// 技能商店分页浏览响应。
#[derive(Debug, Clone, Default, Serialize, Deserialize)]
pub struct SkillBrowseResponse {
    pub items: Vec<SkillStoreItem>,
    pub total: i64,
    pub page: i64,
    #[serde(rename = "pageSize")]
    pub page_size: i64,
}

/// 技能商店列表项(轻量,仅含浏览所需字段)。
/// 配合服务端 `fields=minimal` 参数使用,响应体积缩减 90%+。
#[derive(Debug, Clone, Default, Serialize, Deserialize)]
pub struct SkillStoreListItem {
    pub id: String,
    pub key: String,
    pub name: String,
    pub description: String,
    pub icon: String,
    pub category: String,
    pub version: String,
    pub author: String,
    #[serde(rename = "downloadCount")]
    pub download_count: i64,
    pub tags: Vec<String>,
    #[serde(
        rename = "certificationStatus",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub certification_status: Option<String>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub visibility: Option<String>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub source: Option<String>,
    #[serde(rename = "updatedAt")]
    pub updated_at: String,
}

/// 技能商店轻量浏览响应。
#[derive(Debug, Clone, Default, Serialize, Deserialize)]
pub struct SkillBrowseListResponse {
    pub items: Vec<SkillStoreListItem>,
    pub total: i64,
    pub page: i64,
    #[serde(rename = "pageSize")]
    pub page_size: i64,
}

/// 技能认证状态响应。
#[derive(Debug, Clone, Default, Serialize, Deserialize)]
pub struct CertificationStatus {
    #[serde(rename = "skillId")]
    pub skill_id: String,
    #[serde(rename = "certificationStatus")]
    pub certification_status: String,
    #[serde(
        rename = "certifiedAt",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub certified_at: Option<i64>,
    #[serde(
        rename = "securityLevel",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub security_level: Option<String>,
    #[serde(rename = "securityScore")]
    pub security_score: i64,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub report: Option<serde_json::Value>,
}

// =============================================================================
// Skill Generator
// =============================================================================

/// 技能生成请求。
#[derive(Debug, Clone, Default, Serialize, Deserialize)]
pub struct GenerateSkillRequest {
    pub purpose: String,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub examples: Option<Vec<String>>,
    #[serde(
        rename = "inputHints",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub input_hints: Option<String>,
    #[serde(
        rename = "outputHints",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub output_hints: Option<String>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub category: Option<String>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub language: Option<String>,
}

/// 技能生成结果。
#[derive(Debug, Clone, Default, Serialize, Deserialize)]
pub struct GenerateSkillResult {
    #[serde(rename = "skillName")]
    pub skill_name: String,
    #[serde(rename = "skillKey")]
    pub skill_key: String,
    pub description: String,
    #[serde(rename = "skillMd")]
    pub skill_md: String,
    #[serde(rename = "inputSchema")]
    pub input_schema: String,
    #[serde(rename = "outputSchema")]
    pub output_schema: String,
    #[serde(rename = "testCases")]
    pub test_cases: Vec<String>,
    pub readme: String,
    pub category: String,
    pub tags: Vec<String>,
    pub timeout: i64,
}

/// 技能优化请求。
#[derive(Debug, Clone, Default, Serialize, Deserialize)]
pub struct OptimizeSkillRequest {
    #[serde(rename = "skillName")]
    pub skill_name: String,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub description: Option<String>,
    #[serde(
        rename = "inputSchema",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub input_schema: Option<String>,
    #[serde(
        rename = "outputSchema",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub output_schema: Option<String>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub readme: Option<String>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub aspects: Option<Vec<String>>,
}

/// 技能优化结果。
#[derive(Debug, Clone, Default, Serialize, Deserialize)]
pub struct OptimizeSkillResult {
    #[serde(rename = "optimizedSkill")]
    pub optimized_skill: GenerateSkillResult,
    pub changes: Vec<String>,
    pub score: f64,
}

// =============================================================================
// Unified Tools
// =============================================================================

/// 统一工具视图。
#[derive(Debug, Clone, Default, Serialize, Deserialize)]
pub struct ToolView {
    pub id: String,
    pub key: String,
    pub name: String,
    pub description: String,
    pub icon: String,
    pub category: String,
    #[serde(rename = "inputSchema")]
    pub input_schema: String,
    #[serde(rename = "outputSchema")]
    pub output_schema: String,
    pub timeout: i64,
    #[serde(rename = "isEnabled")]
    pub is_enabled: bool,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub provider: Option<ToolProvider>,
}

/// 工具提供方。
#[derive(Debug, Clone, Default, Serialize, Deserialize)]
pub struct ToolProvider {
    pub id: String,
    pub name: String,
    pub icon: String,
    #[serde(rename = "sourceType")]
    pub source_type: String,
    #[serde(
        rename = "mcpEndpoint",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub mcp_endpoint: Option<String>,
    #[serde(rename = "isEnabled")]
    pub is_enabled: bool,
}

/// 工具列表响应。
#[derive(Debug, Clone, Default, Serialize, Deserialize)]
pub struct ToolListResponse {
    pub skills: Vec<ToolView>,
    pub total: i64,
}

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

    #[test]
    fn skill_store_item_round_trip() {
        let json = r#"{"id":"s1","pluginId":"p1","key":"k","name":"N","description":"D","icon":"i","category":"CODING","inputSchema":"{}","outputSchema":"{}","timeout":30,"retryCount":1,"retryDelay":100,"version":"1.0.0","totalCalls":10,"avgDurationMs":200,"successRate":0.99,"isEnabled":true,"securityLevel":"LOW","securityScore":80,"scope":"TENANT","status":"ACTIVE","downloadCount":5,"tags":["a"],"author":"me","publisherId":"pub","isPublished":true,"pluginName":"pn","pluginIcon":"pi","updatedAt":"2026-06-19T00:00:00Z"}"#;
        let item: SkillStoreItem = serde_json::from_str(json).unwrap();
        assert_eq!(item.id, "s1");
        assert_eq!(item.success_rate, 0.99);
        assert!(item.is_enabled);
        assert_eq!(item.readme, None);
        // round-trip 不丢字段(缺省可选不输出)。
        let back: SkillStoreItem =
            serde_json::from_str(&serde_json::to_string(&item).unwrap()).unwrap();
        assert_eq!(back.download_count, 5);
    }
}