Skip to main content

qualia_core_db/inference/conditioning/
capabilities.rs

1//! Endpoint/model capability evidence.
2
3#[derive(Debug, Clone, Copy, PartialEq, Eq)]
4pub enum SupportLevel {
5    Supported,
6    Unsupported,
7    Unknown,
8}
9
10#[derive(Debug, Clone, Copy, PartialEq, Eq)]
11pub struct BackendCapabilities {
12    pub role_separation: SupportLevel,
13    pub tools: SupportLevel,
14    pub output_grammar: SupportLevel,
15    pub exact_token_count: SupportLevel,
16    pub exact_prefix_kv: SupportLevel,
17    pub streaming: SupportLevel,
18    pub cancellation: SupportLevel,
19    pub usage_reporting: SupportLevel,
20    pub learned_prompts: SupportLevel,
21    /// Can ingest grounded conversational-DAG thread context (RequestPartKind::ChatGraphThread).
22    pub chat_graph_aware: SupportLevel,
23    /// Honours a reserved deliberation (`<think>`) token budget inside the context envelope.
24    pub thinking_budget: SupportLevel,
25    /// Sparse mixture-of-experts gating / expert dispatch execution path.
26    pub moe_execution: SupportLevel,
27    /// Recurrent SSM / GatedDeltaNet hybrid state execution path.
28    pub hybrid_ssm: SupportLevel,
29    /// Mid-decode Prolog Sentinel guard with Deny/Rollback control.
30    pub sentinel_rollback: SupportLevel,
31}
32
33impl BackendCapabilities {
34    /// `BackendCapabilities::native_gguf_baseline`.
35    pub const fn native_gguf_baseline() -> Self {
36        Self {
37            role_separation: SupportLevel::Supported,
38            tools: SupportLevel::Unknown,
39            output_grammar: SupportLevel::Supported,
40            exact_token_count: SupportLevel::Supported,
41            exact_prefix_kv: SupportLevel::Unknown,
42            streaming: SupportLevel::Supported,
43            cancellation: SupportLevel::Supported,
44            usage_reporting: SupportLevel::Supported,
45            learned_prompts: SupportLevel::Unsupported,
46            chat_graph_aware: SupportLevel::Supported,
47            thinking_budget: SupportLevel::Unknown,
48            moe_execution: SupportLevel::Supported,
49            hybrid_ssm: SupportLevel::Supported,
50            sentinel_rollback: SupportLevel::Supported,
51        }
52    }
53
54    /// `BackendCapabilities::mcp_tool_baseline`.
55    pub const fn mcp_tool_baseline() -> Self {
56        Self {
57            role_separation: SupportLevel::Unsupported,
58            tools: SupportLevel::Supported,
59            output_grammar: SupportLevel::Unknown,
60            exact_token_count: SupportLevel::Unknown,
61            exact_prefix_kv: SupportLevel::Unsupported,
62            streaming: SupportLevel::Unknown,
63            cancellation: SupportLevel::Unknown,
64            usage_reporting: SupportLevel::Unknown,
65            learned_prompts: SupportLevel::Unsupported,
66            chat_graph_aware: SupportLevel::Unknown,
67            thinking_budget: SupportLevel::Unknown,
68            moe_execution: SupportLevel::Unknown,
69            hybrid_ssm: SupportLevel::Unknown,
70            sentinel_rollback: SupportLevel::Unsupported,
71        }
72    }
73}
74
75#[cfg(test)]
76mod tests {
77    use super::*;
78
79    #[test]
80    fn baselines_populate_stage_capability_dimensions() {
81        let native = BackendCapabilities::native_gguf_baseline();
82        assert_eq!(native.chat_graph_aware, SupportLevel::Supported);
83        assert_eq!(native.sentinel_rollback, SupportLevel::Supported);
84        assert_eq!(native.moe_execution, SupportLevel::Supported);
85        assert_eq!(native.hybrid_ssm, SupportLevel::Supported);
86        assert_eq!(native.thinking_budget, SupportLevel::Unknown);
87
88        let mcp = BackendCapabilities::mcp_tool_baseline();
89        assert_eq!(mcp.chat_graph_aware, SupportLevel::Unknown);
90        assert_eq!(mcp.sentinel_rollback, SupportLevel::Unsupported);
91        assert_eq!(mcp.moe_execution, SupportLevel::Unknown);
92        assert_eq!(mcp.hybrid_ssm, SupportLevel::Unknown);
93        assert_eq!(mcp.thinking_budget, SupportLevel::Unknown);
94    }
95}