zebflow 0.6.1

Reactive web automation platform — pipelines, templates, and real-time collaboration in a single binary.
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

//! Basic planning strategy: hierarchical decomposition with validation and replanning.
//!
//! Used by ZebtuneAgent (TODO M6) for goal decomposition and adaptive replanning.
//! See `prompts` submodule for the LLM prompt templates that drive each phase.

pub mod prompts;

use serde::{Deserialize, Serialize};

/// One subgoal in a hierarchical plan.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct SubGoal {
    pub id: usize,
    pub description: String,
    pub validation_criteria: String,
    pub steps: Vec<String>,
    pub status: SubGoalStatus,
    pub attempts: u32,
    pub replans: u32,
}

#[derive(Debug, Clone, Copy, Serialize, Deserialize, PartialEq, Eq)]
#[serde(rename_all = "snake_case")]
pub enum SubGoalStatus {
    Pending,
    InProgress,
    Completed,
    Failed,
}

/// Hierarchical plan with subgoals.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct HierarchicalPlan {
    pub objective: String,
    pub subgoals: Vec<SubGoal>,
    pub current_subgoal: usize,
    pub status: PlanStatus,
}

#[derive(Debug, Clone, Copy, Serialize, Deserialize, PartialEq, Eq)]
#[serde(rename_all = "snake_case")]
pub enum PlanStatus {
    Planning,
    Executing,
    Completed,
    Failed,
}

impl HierarchicalPlan {
    pub fn new(objective: String) -> Self {
        Self {
            objective,
            subgoals: Vec::new(),
            current_subgoal: 0,
            status: PlanStatus::Planning,
        }
    }

    pub fn current(&self) -> Option<&SubGoal> {
        self.subgoals.get(self.current_subgoal)
    }

    pub fn current_mut(&mut self) -> Option<&mut SubGoal> {
        self.subgoals.get_mut(self.current_subgoal)
    }

    /// Mark current subgoal complete and advance. Returns false when all subgoals done.
    pub fn complete_current(&mut self) -> bool {
        if let Some(sg) = self.current_mut() {
            sg.status = SubGoalStatus::Completed;
        }
        self.current_subgoal += 1;
        if self.current_subgoal >= self.subgoals.len() {
            self.status = PlanStatus::Completed;
            false
        } else {
            true
        }
    }

    pub fn fail_current(&mut self) {
        if let Some(sg) = self.current_mut() {
            sg.status = SubGoalStatus::Failed;
        }
        self.status = PlanStatus::Failed;
    }

    pub fn progress(&self) -> (usize, usize) {
        let completed = self
            .subgoals
            .iter()
            .filter(|sg| sg.status == SubGoalStatus::Completed)
            .count();
        (completed, self.subgoals.len())
    }
}

/// Validation result for subgoal completion check.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct ValidationResult {
    pub success: bool,
    pub confidence: f64,
    pub reason: String,
}