resuma 1.1.0

Resuma — resumable SSR Rust web framework: zero hydration, islands, server actions, Flow (Axum).
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

//! In-process event bus with replay log (SSE source of truth).

use std::sync::Arc;

use parking_lot::RwLock;
use tokio::sync::broadcast;

use super::types::WorkerEvent;

const BUS_CAPACITY: usize = 256;

/// Per-graph event bus: append-only log + live subscribers.
#[derive(Debug)]
pub struct EventBus {
    tx: broadcast::Sender<WorkerEvent>,
    log: RwLock<Vec<WorkerEvent>>,
}

impl EventBus {
    pub fn new() -> Self {
        let (tx, _) = broadcast::channel(BUS_CAPACITY);
        Self {
            tx,
            log: RwLock::new(Vec::new()),
        }
    }

    pub fn emit(&self, event: WorkerEvent) {
        self.log.write().push(event.clone());
        let _ = self.tx.send(event);
    }

    pub fn subscribe(&self) -> broadcast::Receiver<WorkerEvent> {
        self.tx.subscribe()
    }

    pub fn history(&self) -> Vec<WorkerEvent> {
        self.log.read().clone()
    }
}

impl Default for EventBus {
    fn default() -> Self {
        Self::new()
    }
}

/// Build events with current timestamp.
pub mod emit {
    use serde_json::Value;

    use super::super::id;
    use super::super::types::{GraphId, NodeId, NodeKind, WorkerEvent};

    pub fn log(node: NodeId, message: impl Into<String>) -> WorkerEvent {
        WorkerEvent::Log {
            message: message.into(),
            node,
            timestamp_ms: id::now_ms(),
        }
    }

    pub fn progress(node: NodeId, value: u8) -> WorkerEvent {
        WorkerEvent::Progress {
            value: value.min(100),
            node,
            timestamp_ms: id::now_ms(),
        }
    }

    pub fn ai_thinking(node: NodeId, content: impl Into<String>) -> WorkerEvent {
        WorkerEvent::AiThinking {
            content: content.into(),
            node,
            timestamp_ms: id::now_ms(),
        }
    }

    pub fn tool_call(node: NodeId, tool: impl Into<String>, args: Option<Value>) -> WorkerEvent {
        WorkerEvent::ToolCall {
            tool: tool.into(),
            args,
            node,
            timestamp_ms: id::now_ms(),
        }
    }

    pub fn node_start(node: NodeId, kind: NodeKind) -> WorkerEvent {
        WorkerEvent::NodeStart {
            node,
            kind,
            timestamp_ms: id::now_ms(),
        }
    }

    pub fn node_done(node: NodeId, duration_ms: u64) -> WorkerEvent {
        WorkerEvent::NodeDone {
            node,
            duration_ms,
            timestamp_ms: id::now_ms(),
        }
    }

    pub fn node_failed(node: NodeId, error: impl Into<String>) -> WorkerEvent {
        WorkerEvent::NodeFailed {
            node,
            error: error.into(),
            timestamp_ms: id::now_ms(),
        }
    }

    pub fn result(data: Value) -> WorkerEvent {
        WorkerEvent::Result {
            data,
            timestamp_ms: id::now_ms(),
        }
    }

    pub fn graph_done(graph_id: GraphId) -> WorkerEvent {
        WorkerEvent::GraphDone {
            graph_id,
            timestamp_ms: id::now_ms(),
        }
    }
}

pub type SharedEventBus = Arc<EventBus>;