talos-agent 0.8.0

Core orchestration logic and the agent turn loop
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

use talos_core::message::{SystemCacheMarker, SystemCacheType};
use talos_core::tool::ToolFamily;

/// A description of a tool for inclusion in the system prompt.
///
/// Contains only the name and human-readable description, without the full
/// JSON Schema parameters. This is sufficient for the system prompt context.
#[derive(Debug, Clone, PartialEq, Default)]
pub struct ToolDescription {
    pub name: String,
    pub description: String,
    pub parameters: serde_json::Value,
    pub family: ToolFamily,
}

/// A context file for inclusion in the system prompt.
///
/// Typically loaded from `AGENTS.md` files in the workspace hierarchy.
#[derive(Debug, Clone, PartialEq)]
pub struct ContextFile {
    /// Relative or absolute path to the source file.
    pub path: String,
    /// Full content of the file.
    pub content: String,
}

/// Activated Skill content included in the model-visible stable prompt prefix.
#[derive(Debug, Clone, PartialEq, Eq)]
pub struct ActivatedSkillContext {
    /// Skill name selected by the user.
    pub name: String,
    /// Bounded Skill body and any explicitly loaded references.
    pub content: String,
}

/// Type of cache control marker for prompt sections.
///
/// Used to indicate which sections of the system prompt are stable across
/// turns and suitable for provider-side caching.
#[derive(Debug, Clone, PartialEq)]
pub enum CacheType {
    /// The section is stable and suitable for ephemeral caching.
    /// Content in this range should be cached by the provider and reused
    /// across turns when the section remains unchanged.
    Ephemeral,
}

/// A cache marker indicating a byte range suitable for provider caching.
///
/// Each marker specifies the offset and length of a cacheable section within
/// the assembled prompt, along with the cache type.
#[derive(Debug, Clone, PartialEq)]
pub struct CacheMarker {
    /// Starting byte offset of the cacheable section.
    pub offset: usize,
    /// Length of the cacheable section in bytes.
    pub length: usize,
    /// Type of caching to apply to this section.
    pub cache_type: CacheType,
}

impl From<CacheMarker> for SystemCacheMarker {
    fn from(marker: CacheMarker) -> Self {
        let cache_type = match marker.cache_type {
            CacheType::Ephemeral => SystemCacheType::Ephemeral,
        };
        Self {
            offset: marker.offset,
            length: marker.length,
            cache_type,
        }
    }
}