perspt-sdk 0.6.6

Domain-neutral SRBN agent SDK for Perspt: residual energy, measured acceptance gate, spectral diagnostics, and stabilization-kernel adapter (PSP-8)
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

//! Prompt stages (PSP-10 system 23's runtime types).

use serde::{Deserialize, Serialize};

/// The declared prompt stages. Platform stages compose the universal
/// envelope; domain stages compose the domain program layered on top.
#[derive(Debug, Clone, Copy, PartialEq, Eq, PartialOrd, Ord, Hash, Serialize, Deserialize)]
#[serde(rename_all = "snake_case")]
pub enum PromptStage {
    // Platform stages.
    SessionBootstrap,
    GraphPlan,
    ToolDiscovery,
    ConversationCompact,
    ExternalReconcile,
    // Domain stages.
    RepositoryExplore,
    BranchStrategy,
    BranchPropose,
    BranchCorrect,
    BranchReview,
    Adjudicate,
    EvidenceSummarize,
}

impl PromptStage {
    /// The directory name a stage's section files live under.
    pub fn dir_name(&self) -> &'static str {
        match self {
            PromptStage::SessionBootstrap => "session_bootstrap",
            PromptStage::GraphPlan => "graph_plan",
            PromptStage::ToolDiscovery => "tool_discovery",
            PromptStage::ConversationCompact => "conversation_compact",
            PromptStage::ExternalReconcile => "external_reconcile",
            PromptStage::RepositoryExplore => "repository_explore",
            PromptStage::BranchStrategy => "branch_strategy",
            PromptStage::BranchPropose => "branch_propose",
            PromptStage::BranchCorrect => "branch_correct",
            PromptStage::BranchReview => "branch_review",
            PromptStage::Adjudicate => "adjudicate",
            PromptStage::EvidenceSummarize => "evidence_summarize",
        }
    }

    /// Parse a stage directory name.
    pub fn from_dir_name(name: &str) -> Option<Self> {
        [
            PromptStage::SessionBootstrap,
            PromptStage::GraphPlan,
            PromptStage::ToolDiscovery,
            PromptStage::ConversationCompact,
            PromptStage::ExternalReconcile,
            PromptStage::RepositoryExplore,
            PromptStage::BranchStrategy,
            PromptStage::BranchPropose,
            PromptStage::BranchCorrect,
            PromptStage::BranchReview,
            PromptStage::Adjudicate,
            PromptStage::EvidenceSummarize,
        ]
        .into_iter()
        .find(|stage| stage.dir_name() == name)
    }
}

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

    #[test]
    fn dir_names_round_trip() {
        for stage in [
            PromptStage::SessionBootstrap,
            PromptStage::GraphPlan,
            PromptStage::BranchCorrect,
            PromptStage::EvidenceSummarize,
        ] {
            assert_eq!(PromptStage::from_dir_name(stage.dir_name()), Some(stage));
        }
        assert_eq!(PromptStage::from_dir_name("nonsense"), None);
    }
}