Skip to main content

qualia_core_db/inference/conditioning/
render.rs

1//! Shared text and message rendering for backend lowering.
2
3use super::compile::CompiledPlanSummary;
4use super::select::EvidencePart;
5use super::spec::{ConditioningError, ConditioningSpec};
6
7#[derive(Debug, Clone, Copy, PartialEq, Eq)]
8pub enum RenderTarget {
9    NativeChatml,
10    NativePlain,
11    McpEnvelope,
12}
13
14#[derive(Debug, Clone, Copy)]
15pub struct RenderedRequestSummary {
16    pub bytes_written: usize,
17    pub target: RenderTarget,
18}
19
20/// Helper to write bytes into caller slice.
21#[inline]
22fn write_str(buf: &mut [u8], offset: &mut usize, s: &str) -> Result<(), ConditioningError> {
23    let bytes = s.as_bytes();
24    if *offset + bytes.len() > buf.len() {
25        return Err(ConditioningError::OutputBufferFull);
26    }
27    buf[*offset..*offset + bytes.len()].copy_from_slice(bytes);
28    *offset += bytes.len();
29    Ok(())
30}
31
32/// Render a compiled plan and its selected evidence into a caller-supplied byte buffer.
33/// Completely zero-heap: returns bytes written in caller's buffer.
34pub fn render_into<'a>(
35    plan: &CompiledPlanSummary<'a>,
36    spec: &ConditioningSpec<'a>,
37    selected_evidence: &[EvidencePart<'a>],
38    target: RenderTarget,
39    out: &mut [u8],
40) -> Result<RenderedRequestSummary, ConditioningError> {
41    let mut offset = 0;
42
43    match target {
44        RenderTarget::NativeChatml => {
45            // System block: instructions + requirements
46            write_str(out, &mut offset, "<|im_start|>system\n# Profile: ")?;
47            write_str(out, &mut offset, plan.profile_id)?;
48            write_str(out, &mut offset, "\n# Objective: ")?;
49            write_str(out, &mut offset, plan.objective)?;
50            write_str(out, &mut offset, "\n\n# Requirements:\n")?;
51
52            for req in spec.requirements {
53                write_str(out, &mut offset, "- [")?;
54                write_str(out, &mut offset, req.id)?;
55                write_str(out, &mut offset, "] ")?;
56                write_str(out, &mut offset, req.rule)?;
57                write_str(out, &mut offset, "\n")?;
58            }
59
60            if !selected_evidence.is_empty() {
61                write_str(out, &mut offset, "\n# Evidence:\n")?;
62                for ev in selected_evidence {
63                    write_str(out, &mut offset, "Source ")?;
64                    write_str(out, &mut offset, ev.source_id)?;
65                    write_str(out, &mut offset, ": ")?;
66                    write_str(out, &mut offset, ev.content)?;
67                    write_str(out, &mut offset, "\n")?;
68                }
69            }
70            write_str(out, &mut offset, "<|im_end|>\n<|im_start|>user\n")?;
71            write_str(out, &mut offset, plan.objective)?;
72            write_str(out, &mut offset, "<|im_end|>\n<|im_start|>assistant\n")?;
73        }
74        RenderTarget::NativePlain | RenderTarget::McpEnvelope => {
75            // Plain text envelope
76            write_str(out, &mut offset, "Objective: ")?;
77            write_str(out, &mut offset, plan.objective)?;
78            write_str(out, &mut offset, "\n\nRequirements:\n")?;
79
80            for req in spec.requirements {
81                write_str(out, &mut offset, "- ")?;
82                write_str(out, &mut offset, req.rule)?;
83                write_str(out, &mut offset, "\n")?;
84            }
85
86            if !selected_evidence.is_empty() {
87                write_str(out, &mut offset, "\nEvidence:\n")?;
88                for ev in selected_evidence {
89                    write_str(out, &mut offset, "- ")?;
90                    write_str(out, &mut offset, ev.content)?;
91                    write_str(out, &mut offset, "\n")?;
92                }
93            }
94        }
95    }
96
97    Ok(RenderedRequestSummary {
98        bytes_written: offset,
99        target,
100    })
101}