langsmith-rust 0.1.3

Rust crate for manual tracing to LangSmith, providing similar ergonomics to the Python and TypeScript SDKs
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

use crate::client::LangSmithClient;
use crate::models::run::RunType;
use crate::tracing::tracer::Tracer;
use crate::tracing::context::TraceContext;
use serde_json::Value;
use std::sync::Arc;
use uuid::Uuid;

/// Factory for creating Tracer instances with different configurations
pub struct TracerFactory;

impl TracerFactory {
    /// Create a basic tracer
    pub fn create(name: impl Into<String>, run_type: RunType, inputs: Value) -> Tracer {
        Tracer::new(name, run_type, inputs)
    }

    /// Create a tracer with a specific client
    pub fn create_with_client(
        name: impl Into<String>,
        run_type: RunType,
        inputs: Value,
        client: Arc<LangSmithClient>,
    ) -> Tracer {
        Tracer::new(name, run_type, inputs).with_client(client)
    }

    /// Create a tracer with thread context
    pub fn create_with_thread(
        name: impl Into<String>,
        run_type: RunType,
        inputs: Value,
        thread_id: String,
    ) -> Tracer {
        Tracer::new(name, run_type, inputs).with_thread_id(thread_id)
    }

    /// Create a tracer with trace context
    pub fn create_with_context(
        name: impl Into<String>,
        run_type: RunType,
        inputs: Value,
        context: &TraceContext,
    ) -> Tracer {
        Tracer::new(name, run_type, inputs).with_context(context)
    }

    /// Create a root tracer (for starting a new trace)
    pub fn create_root(
        name: impl Into<String>,
        run_type: RunType,
        inputs: Value,
    ) -> Tracer {
        let mut tracer = Tracer::new(name, run_type, inputs);
        // Ensure trace_id is set
        use uuid::Uuid;
        let trace_id = Uuid::new_v4();
        tracer.run.trace_id = Some(trace_id);
        // Generate dotted_order for root
        tracer.run.dotted_order = Some(tracer.run.generate_dotted_order(None));
        tracer
    }

    /// Create a tracer for a graph node
    pub fn create_for_node(
        node_name: impl Into<String>,
        run_type: RunType,
        inputs: Value,
        parent_context: Option<&TraceContext>,
    ) -> Tracer {
        let mut tracer = Tracer::new(node_name, run_type, inputs);
        
        if let Some(context) = parent_context {
            tracer = tracer.with_context(context);
        } else {
            // Create new root context
            let trace_id = Uuid::new_v4();
            let context = TraceContext::new(trace_id);
            tracer = tracer.with_context(&context);
        }
        
        tracer
    }
}