iron-core 0.1.37

Core AgentIron loop, session state, and tool registry
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
97
98
99
100
101
102
103
104
105
106
107
108
109

//! Legacy linear prompt assembly and repository-instruction rendering.

use crate::prompt::config::RepoInstructionPayload;

/// Assembles instruction sources into provider-ready text.
pub struct PromptAssembler;

impl PromptAssembler {
    /// Concatenates non-empty instruction sources in argument order.
    ///
    /// The order is baseline, repository instructions, additional inline
    /// blocks, session instructions, skill instructions, and runtime context.
    /// Adjacent sources are separated by two newlines.
    pub fn assemble(
        baseline: &str,
        repo_payload: &RepoInstructionPayload,
        additional_inline: &[String],
        session_instructions: Option<&str>,
        skill_instructions: Option<&str>,
        runtime_context: &str,
    ) -> String {
        let mut parts: Vec<String> = Vec::new();

        if !baseline.is_empty() {
            parts.push(baseline.to_string());
        }

        let has_repo =
            !repo_payload.sources.is_empty() || !repo_payload.additional_files.is_empty();
        if has_repo {
            parts.push(Self::render_repo_instructions(repo_payload));
        }

        for block in additional_inline {
            if !block.is_empty() {
                parts.push(block.clone());
            }
        }

        if let Some(instr) = session_instructions {
            if !instr.is_empty() {
                parts.push(instr.to_string());
            }
        }

        if let Some(skills) = skill_instructions {
            if !skills.is_empty() {
                parts.push(skills.to_string());
            }
        }

        if !runtime_context.is_empty() {
            parts.push(runtime_context.to_string());
        }

        parts.join("\n\n")
    }

    /// Renders repository and additional instruction files with source paths.
    ///
    /// Sources retain their payload order. Returns an empty string when the
    /// payload contains no files.
    pub fn render_repo_instructions(payload: &RepoInstructionPayload) -> String {
        if payload.sources.is_empty() && payload.additional_files.is_empty() {
            return String::new();
        }

        let mut section = String::from("<repository_instructions>");
        section.push('\n');

        let source_names: Vec<String> = payload
            .sources
            .iter()
            .map(|s| s.scope.join(&s.filename).display().to_string())
            .chain(
                payload
                    .additional_files
                    .iter()
                    .map(|f| f.path.display().to_string()),
            )
            .collect();

        if !source_names.is_empty() {
            section.push_str("<repository_instruction_sources>\n");
            for name in &source_names {
                section.push_str(&format!("- {}\n", name));
            }
            section.push_str("</repository_instruction_sources>\n");
        }

        for src in &payload.sources {
            section.push_str(&format!(
                "<file_content path=\"{}\">\n",
                src.scope.join(&src.filename).display()
            ));
            section.push_str(&src.content);
            section.push_str("\n</file_content>\n");
        }

        for f in &payload.additional_files {
            section.push_str(&format!("<file_content path=\"{}\">\n", f.path.display()));
            section.push_str(&f.content);
            section.push_str("\n</file_content>\n");
        }

        section.push_str("</repository_instructions>");
        section
    }
}