ralph-workflow 0.7.18

PROMPT-driven multi-agent orchestrator for git repos
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

impl PipelineEvent {
    #[must_use] 
    pub const fn prompt_input_oversize_detected(
        phase: PipelinePhase,
        kind: PromptInputKind,
        content_id_sha256: String,
        size_bytes: u64,
        limit_bytes: u64,
        policy: String,
    ) -> Self {
        Self::PromptInput(PromptInputEvent::OversizeDetected {
            phase,
            kind,
            content_id_sha256,
            size_bytes,
            limit_bytes,
            policy,
        })
    }

    #[must_use] 
    pub const fn planning_inputs_materialized(iteration: u32, prompt: MaterializedPromptInput) -> Self {
        Self::PromptInput(PromptInputEvent::PlanningInputsMaterialized {
            iteration,
            prompt,
        })
    }

    #[must_use] 
    pub const fn development_inputs_materialized(
        iteration: u32,
        prompt: MaterializedPromptInput,
        plan: MaterializedPromptInput,
    ) -> Self {
        Self::PromptInput(PromptInputEvent::DevelopmentInputsMaterialized {
            iteration,
            prompt,
            plan,
        })
    }

    #[must_use] 
    pub const fn review_inputs_materialized(
        pass: u32,
        plan: MaterializedPromptInput,
        diff: MaterializedPromptInput,
    ) -> Self {
        Self::PromptInput(PromptInputEvent::ReviewInputsMaterialized { pass, plan, diff })
    }

    #[must_use] 
    pub const fn commit_inputs_materialized(attempt: u32, diff: MaterializedPromptInput) -> Self {
        Self::PromptInput(PromptInputEvent::CommitInputsMaterialized { attempt, diff })
    }

    #[must_use] 
    pub const fn xsd_retry_last_output_materialized(
        phase: PipelinePhase,
        scope_id: u32,
        last_output: MaterializedPromptInput,
    ) -> Self {
        Self::PromptInput(PromptInputEvent::XsdRetryLastOutputMaterialized {
            phase,
            scope_id,
            last_output,
        })
    }

    /// Create a `PromptPermissionsLocked` event.
    #[must_use] 
    pub const fn prompt_permissions_locked(warning: Option<String>) -> Self {
        Self::PromptInput(PromptInputEvent::PromptPermissionsLocked { warning })
    }

    /// Create a `PromptPermissionsRestoreWarning` event.
    #[must_use] 
    pub const fn prompt_permissions_restore_warning(warning: String) -> Self {
        Self::PromptInput(PromptInputEvent::PromptPermissionsRestoreWarning { warning })
    }

    /// Create a `TemplateRendered` event.
    ///
    /// Emitted by prompt preparation handlers after template rendering.
    /// The substitution log enables validation based on tracked substitutions.
    #[must_use] 
    pub const fn template_rendered(
        phase: PipelinePhase,
        template_name: String,
        log: crate::prompts::SubstitutionLog,
    ) -> Self {
        Self::PromptInput(PromptInputEvent::TemplateRendered {
            phase,
            template_name,
            log,
        })
    }
}