operonx 0.7.0

High-performance Rust execution backend for Operon workflows
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

//! Telemetry plugin registration — wires `langfuse` (and eventually `otel`)
//! categories into the global [`ConfigRegistry`].
//!
//! Mirrors Python [`operonx/telemetry/plugin.py`](../../../../operonx/telemetry/plugin.py).
//! Per §6b.11 the Python guard is a module-level `_registered` flag; Rust's
//! `register()` functions check the registry to stay idempotent.

use std::sync::Arc;

use serde_json::Value;

use crate::core::exceptions::OperonError;
use crate::core::registry::{registry, ConfigDict, Factory, ResourceInstance};
use crate::telemetry::backends::langfuse::{LangfuseClient, LangfuseConfig};

/// Typed wrapper stored in [`ResourceHub`](crate::core::registry::ResourceHub)
/// so the telemetry layer can `Arc::downcast` cleanly.
pub struct LangfuseResource(pub Arc<LangfuseClient>);

/// Register the `langfuse` category factory (idempotent).
pub fn register_langfuse() -> Result<(), OperonError> {
    if registry().get_factory("langfuse").is_some() {
        return Ok(());
    }
    let factory: Factory = Arc::new(|cfg: ConfigDict| {
        let typed: LangfuseConfig = serde_json::from_value(Value::Object(cfg))?;
        let client = Arc::new(LangfuseClient::new(typed));
        Ok(Arc::new(LangfuseResource(client)) as ResourceInstance)
    });
    registry().register("langfuse", factory, Some("LangfuseConfig"))
}

/// Register every built-in telemetry plugin. Currently just Langfuse — OTEL
/// lands in v0.7 per §6a.
pub fn register_all() -> Result<(), OperonError> {
    register_langfuse()?;
    Ok(())
}

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

    #[test]
    fn register_all_installs_langfuse() {
        register_all().unwrap();
        assert!(registry().get_factory("langfuse").is_some());
    }
}