met 1.0.0-beta-preview

Metrale Engine: pure Rust LLM inference server (HTTP API, scheduler, TUI, CLI).
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

// SPDX-License-Identifier: MIT OR Apache-2.0

//! 2026-09-26: The OpenAI assistant message and its URL-citation
//! annotations.
//!
//! Owner: server (OpenAI adapter).
//! Invariants: none beyond the types.

use serde::{Deserialize, Serialize};

#[derive(Debug, Serialize, Clone)]
pub struct ChatMessage {
    pub role: String,
    /// 2026-09-26: The reasoning trace, under one key only. 2026-10-14: the
    /// key and its presence follow the model's `ReasoningWire`
    /// (`reasoning_wire.rs`). Requests may send either name
    /// (`alias = "reasoning"` on `IncomingMessage::reasoning_content`).
    #[serde(flatten)]
    pub reasoning: super::WireReasoning,
    pub content: Option<String>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub tool_calls: Option<Vec<crate::tool_parser::ToolCall>>,
    /// 2026-09-26: URL citations found in the final `content`; omitted when
    /// there are none.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub annotations: Option<Vec<Annotation>>,
    /// 2026-09-26: The refusal sentence found by `refusal::detect`; the
    /// blocking path then sets `content` to null.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub refusal: Option<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(tag = "type", rename_all = "snake_case")]
pub enum Annotation {
    UrlCitation { url_citation: UrlCitation },
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct UrlCitation {
    pub start_index: usize,
    pub end_index: usize,
    pub url: String,
    pub title: String,
}

impl From<crate::citation::Citation> for Annotation {
    fn from(c: crate::citation::Citation) -> Self {
        Annotation::UrlCitation {
            url_citation: UrlCitation {
                start_index: c.start_index,
                end_index: c.end_index,
                url: c.url,
                title: c.title,
            },
        }
    }
}

/// 2026-09-26: [`crate::citation::extract_url_citations`] as annotations;
/// `None` when it finds none.
pub fn extract_url_annotations(content: &str) -> Option<Vec<Annotation>> {
    let cits = crate::citation::extract_url_citations(content);
    if cits.is_empty() {
        None
    } else {
        Some(cits.into_iter().map(Annotation::from).collect())
    }
}

/// 2026-09-26: [`crate::citation::merged_citations`] (URLs plus structured
/// citations) as annotations; `None` when it finds none.
pub fn merged_annotations(content: &str) -> Option<Vec<Annotation>> {
    crate::citation::merged_citations(content)
        .map(|cits| cits.into_iter().map(Annotation::from).collect())
}