sqry-nl 12.1.2

Natural language to sqry query translation layer
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

//! Intent classification using MiniLM-L6-v2 ONNX model.
//!
//! The `classifier` feature gates the ONNX-backed implementation; the
//! [`resolve`] submodule (and its public API) is available
//! unconditionally so call sites — CLI, MCP, LSP, daemon — share a
//! single canonical model-directory lookup chain regardless of whether
//! the runtime classifier is compiled in.

#[cfg(feature = "classifier")]
mod calibration;
#[cfg(feature = "classifier")]
pub mod download;
#[cfg(feature = "classifier")]
pub mod manifest;
#[cfg(feature = "classifier")]
mod model;
#[cfg(feature = "classifier")]
pub mod pool;
pub mod resolve;
#[cfg(feature = "classifier")]
mod tokenizer_wrapper;

#[cfg(feature = "classifier")]
pub use calibration::CalibrationParams;
#[cfg(feature = "classifier")]
pub use download::{Downloader, FileDownloader, UreqDownloader, ensure_model_in_cache};
#[cfg(feature = "classifier")]
pub use manifest::Manifest;
#[cfg(feature = "classifier")]
pub use model::{IntentClassifier, onnx_runtime_install_hint};
#[cfg(feature = "classifier")]
pub use pool::{ClassifierPool, POOL_DEFAULT, POOL_MAX, POOL_MIN, PoolGuard, resolve_pool_size};
pub use resolve::{DirsLike, RealDirs, ResolverLevel, TrustMode, resolve_model_dir};
#[cfg(feature = "classifier")]
pub use tokenizer_wrapper::SharedClassifier;

/// Trusted, baked-in expected manifest snapshot.
///
/// Embedded into the binary at compile time via `include_str!` of
/// `sqry-nl/models/manifest.json`. Every trusted-mode download
/// (NL03's `ensure_model_in_cache`) verifies the streamed archive
/// SHA-256 against this snapshot before extraction, anchoring trust at
/// the binary itself rather than the on-disk cache.
///
/// Parsed lazily on first access and cached for the process lifetime.
///
/// # Panics
///
/// `Manifest::parse` is fallible, but the input is a build-time
/// constant. If it ever fails to parse the build is broken in a way
/// that should be caught by `cargo test` (see
/// `manifest::tests::parses_real_committed_manifest`). We unwrap here
/// because a malformed embedded manifest is a programmer error, not a
/// runtime condition.
#[cfg(feature = "classifier")]
pub static BAKED_MANIFEST: std::sync::LazyLock<Manifest> = std::sync::LazyLock::new(|| {
    Manifest::parse(include_str!("../../models/manifest.json"))
        .expect("baked-in models/manifest.json must be valid JSON (build-time invariant)")
});

#[cfg(not(feature = "classifier"))]
use crate::error::ClassifierError;
#[cfg(not(feature = "classifier"))]
use crate::types::{ClassificationResult, Intent};

/// Stub classifier for when the `classifier` feature is disabled.
///
/// Always returns `Intent::Ambiguous` with low confidence.
#[cfg(not(feature = "classifier"))]
pub struct IntentClassifier;

#[cfg(not(feature = "classifier"))]
impl IntentClassifier {
    /// Create a stub classifier.
    pub fn new() -> Result<Self, ClassifierError> {
        Ok(Self)
    }

    /// Classify intent (stub - always returns Ambiguous).
    pub fn classify(&self, _input: &str) -> Result<ClassificationResult, ClassifierError> {
        Ok(ClassificationResult {
            intent: Intent::Ambiguous,
            confidence: 0.0,
            all_probabilities: vec![0.0; Intent::NUM_CLASSES],
            model_version: "stub".to_string(),
        })
    }
}

#[cfg(not(feature = "classifier"))]
impl Default for IntentClassifier {
    fn default() -> Self {
        Self
    }
}