vv-agent 0.7.1

VectorVein agent runtime, SDK, CLI, tools, and workspace backends
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

use std::sync::{Arc, Mutex};

use serde_json::{Map, Value};

#[derive(Clone)]
pub struct PromptSection {
    pub id: String,
    stable: bool,
    source: String,
    cache_hint: Option<String>,
    metadata: Map<String, Value>,
    compute: Arc<dyn Fn() -> String + Send + Sync>,
    cached_value: Arc<Mutex<Option<String>>>,
}

impl PromptSection {
    pub fn new(
        id: impl Into<String>,
        compute: impl Fn() -> String + Send + Sync + 'static,
        stable: bool,
    ) -> Self {
        Self {
            id: id.into(),
            stable,
            source: String::new(),
            cache_hint: None,
            metadata: Map::new(),
            compute: Arc::new(compute),
            cached_value: Arc::new(Mutex::new(None)),
        }
    }

    pub fn constant(id: impl Into<String>, text: impl Into<String>, stable: bool) -> Self {
        let text = text.into();
        Self::new(id, move || text.clone(), stable)
    }

    pub fn source(mut self, source: impl Into<String>) -> Self {
        self.source = source.into();
        self
    }

    pub fn cache_hint(mut self, cache_hint: impl Into<String>) -> Self {
        self.cache_hint = Some(cache_hint.into());
        self
    }

    pub fn metadata(mut self, key: impl Into<String>, value: Value) -> Self {
        self.metadata.insert(key.into(), value);
        self
    }

    pub fn get_value(&self) -> String {
        if self.stable {
            let mut cached = self.cached_value.lock().expect("prompt section cache");
            if let Some(value) = cached.as_ref() {
                return value.clone();
            }
            let value = (self.compute)();
            *cached = Some(value.clone());
            return value;
        }
        (self.compute)()
    }

    pub fn invalidate(&self) {
        let mut cached = self.cached_value.lock().expect("prompt section cache");
        *cached = None;
    }

    pub fn to_metadata(&self) -> Option<Value> {
        let text = self.get_value().trim().to_string();
        if text.is_empty() {
            return None;
        }
        let mut payload = Map::from_iter([
            ("id".to_string(), Value::String(self.id.clone())),
            ("text".to_string(), Value::String(text)),
            ("stable".to_string(), Value::Bool(self.stable)),
        ]);
        if !self.source.is_empty() {
            payload.insert("source".to_string(), Value::String(self.source.clone()));
        }
        if let Some(cache_hint) = &self.cache_hint {
            payload.insert("cache_hint".to_string(), Value::String(cache_hint.clone()));
        }
        if !self.metadata.is_empty() {
            payload.insert("metadata".to_string(), Value::Object(self.metadata.clone()));
        }
        Some(Value::Object(payload))
    }

    pub fn stable(&self) -> bool {
        self.stable
    }
}