agentic-workflow 0.1.0

Universal orchestration engine — workflows, pipelines, state machines, batch processing, and every coordination pattern
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

use chrono::{DateTime, Utc};
use serde::{Deserialize, Serialize};

use super::workflow::CompletionPolicy;

/// Fan-out/fan-in step definition.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct FanOutStep {
    pub id: String,
    pub destinations: Vec<FanOutDestination>,
    pub completion_policy: CompletionPolicy,
    pub aggregator: ResultAggregator,
    pub partial_success_threshold: Option<f64>,
    pub timeout_ms: Option<u64>,
}

/// A single destination in a fan-out.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct FanOutDestination {
    pub id: String,
    pub name: String,
    pub step_config: serde_json::Value,
}

/// How to merge results from fan-out branches.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub enum ResultAggregator {
    Concat,
    Merge,
    Reduce { expression: String },
    First,
    Last,
    Custom { function: String },
}

/// Status of an executing fan-out.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct FanOutStatus {
    pub fanout_id: String,
    pub execution_id: String,
    pub branches: Vec<FanOutBranch>,
    pub started_at: DateTime<Utc>,
    pub completed: bool,
}

/// Status of a single fan-out branch.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct FanOutBranch {
    pub destination_id: String,
    pub status: FanOutBranchStatus,
    pub output: Option<serde_json::Value>,
    pub error: Option<String>,
    pub duration_ms: Option<u64>,
}

#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
pub enum FanOutBranchStatus {
    Pending,
    Running,
    Success,
    Failed,
    TimedOut,
    Cancelled,
}