agentics-domain 0.3.0

Domain types and validation models for the Agentics challenge platform.
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
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176

//! Challenge review record response DTOs.

use serde::{Deserialize, Serialize};

use crate::models::auth::GithubUserId;
use crate::models::github::GithubPullRequestNumber;
use crate::models::hashes::{GitCommitSha, Sha256Digest};
use crate::models::ids::{ChallengeReviewRecordId, ChallengeReviewValidationRecordId, HumanId};
use crate::models::names::ChallengeName;
use crate::models::paths::RepoRelativePath;
use crate::models::urls::{GithubPullRequestUrl, GithubRepoRemote};

use super::lifecycle::{ChallengeReviewRecordStatus, ChallengeReviewValidationStatus};
use super::manifest::{ChallengeCreationManifest, ChallengeCreationRequestKind};
use super::private_assets::ChallengePrivateAssetResponse;

/// API response for one validation record.
#[derive(Debug, Clone, Serialize, Deserialize, schemars::JsonSchema)]
pub struct ChallengeReviewValidationRecordResponse {
    pub id: ChallengeReviewValidationRecordId,
    pub review_record_id: ChallengeReviewRecordId,
    pub status: ChallengeReviewValidationStatus,
    pub message: String,
    pub repository_path: String,
    pub manifest_sha256: Sha256Digest,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub bundle_sha256: Option<Sha256Digest>,
    pub created_at: String,
}

/// Creator-facing validation record response without server-local checkout paths.
#[derive(Debug, Clone, Serialize, Deserialize, schemars::JsonSchema)]
pub struct CreatorChallengeReviewValidationRecordResponse {
    pub id: ChallengeReviewValidationRecordId,
    pub review_record_id: ChallengeReviewRecordId,
    pub status: ChallengeReviewValidationStatus,
    pub message: String,
    pub manifest_sha256: Sha256Digest,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub bundle_sha256: Option<Sha256Digest>,
    pub created_at: String,
}

/// API response for one challenge review record.
#[derive(Debug, Clone, Serialize, Deserialize, schemars::JsonSchema)]
pub struct ChallengeReviewRecordResponse {
    pub id: ChallengeReviewRecordId,
    pub challenge_name: ChallengeName,
    pub request: ChallengeCreationRequestKind,
    pub status: ChallengeReviewRecordStatus,
    pub creator_human_id: HumanId,
    pub creator_github_user_id: GithubUserId,
    pub creator_github_login: String,
    pub repo_url: GithubRepoRemote,
    pub pr_number: GithubPullRequestNumber,
    pub pr_url: GithubPullRequestUrl,
    pub commit_sha: GitCommitSha,
    pub challenge_path: RepoRelativePath,
    pub manifest_sha256: Sha256Digest,
    pub manifest: ChallengeCreationManifest,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub validation_bundle_sha256: Option<Sha256Digest>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub approved_bundle_sha256: Option<Sha256Digest>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub validation_message: Option<String>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub validation_repository_path: Option<String>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub published_challenge_name: Option<ChallengeName>,
    #[serde(default)]
    pub private_assets: Vec<ChallengePrivateAssetResponse>,
    #[serde(default)]
    pub validation_records: Vec<ChallengeReviewValidationRecordResponse>,
    pub created_at: String,
    pub updated_at: String,
}

/// Creator-facing response for one challenge review record.
#[derive(Debug, Clone, Serialize, Deserialize, schemars::JsonSchema)]
pub struct CreatorChallengeReviewRecordResponse {
    pub id: ChallengeReviewRecordId,
    pub challenge_name: ChallengeName,
    pub request: ChallengeCreationRequestKind,
    pub status: ChallengeReviewRecordStatus,
    pub creator_human_id: HumanId,
    pub creator_github_user_id: GithubUserId,
    pub creator_github_login: String,
    pub repo_url: GithubRepoRemote,
    pub pr_number: GithubPullRequestNumber,
    pub pr_url: GithubPullRequestUrl,
    pub commit_sha: GitCommitSha,
    pub challenge_path: RepoRelativePath,
    pub manifest_sha256: Sha256Digest,
    pub manifest: ChallengeCreationManifest,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub validation_bundle_sha256: Option<Sha256Digest>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub approved_bundle_sha256: Option<Sha256Digest>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub validation_message: Option<String>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub published_challenge_name: Option<ChallengeName>,
    #[serde(default)]
    pub private_assets: Vec<ChallengePrivateAssetResponse>,
    #[serde(default)]
    pub validation_records: Vec<CreatorChallengeReviewValidationRecordResponse>,
    pub created_at: String,
    pub updated_at: String,
}

impl From<ChallengeReviewValidationRecordResponse>
    for CreatorChallengeReviewValidationRecordResponse
{
    /// Drop admin-only checkout path data for creator surfaces.
    fn from(record: ChallengeReviewValidationRecordResponse) -> Self {
        Self {
            id: record.id,
            review_record_id: record.review_record_id,
            status: record.status,
            message: record.message,
            manifest_sha256: record.manifest_sha256,
            bundle_sha256: record.bundle_sha256,
            created_at: record.created_at,
        }
    }
}

impl From<ChallengeReviewRecordResponse> for CreatorChallengeReviewRecordResponse {
    /// Drop admin-only checkout path data for creator surfaces.
    fn from(review_record: ChallengeReviewRecordResponse) -> Self {
        Self {
            id: review_record.id,
            challenge_name: review_record.challenge_name,
            request: review_record.request,
            status: review_record.status,
            creator_human_id: review_record.creator_human_id,
            creator_github_user_id: review_record.creator_github_user_id,
            creator_github_login: review_record.creator_github_login,
            repo_url: review_record.repo_url,
            pr_number: review_record.pr_number,
            pr_url: review_record.pr_url,
            commit_sha: review_record.commit_sha,
            challenge_path: review_record.challenge_path,
            manifest_sha256: review_record.manifest_sha256,
            manifest: review_record.manifest,
            validation_bundle_sha256: review_record.validation_bundle_sha256,
            approved_bundle_sha256: review_record.approved_bundle_sha256,
            validation_message: review_record.validation_message,
            published_challenge_name: review_record.published_challenge_name,
            private_assets: review_record.private_assets,
            validation_records: review_record
                .validation_records
                .into_iter()
                .map(CreatorChallengeReviewValidationRecordResponse::from)
                .collect(),
            created_at: review_record.created_at,
            updated_at: review_record.updated_at,
        }
    }
}

/// List response for admin challenge review record review.
#[derive(Debug, Clone, Serialize, Deserialize, schemars::JsonSchema)]
pub struct ChallengeReviewRecordListResponse {
    pub items: Vec<ChallengeReviewRecordResponse>,
}

/// Admin response returned after abandoning stale review records and deleting
/// purge-eligible unpublished private asset records.
#[derive(Debug, Clone, Serialize, Deserialize, schemars::JsonSchema)]
pub struct ChallengeReviewRecordCleanupResponse {
    pub abandoned_review_records: i64,
    pub purged_private_assets: i64,
    pub purged_temporary_storage_objects: i64,
}