1use std::path::PathBuf;
4
5pub type Result<T> = std::result::Result<T, Error>;
7
8#[derive(Debug, thiserror::Error)]
10#[non_exhaustive]
11pub enum Error {
12 #[error("invalid runtime configuration: {0}")]
14 InvalidConfig(String),
15
16 #[error("backend `{backend}` is not compiled; enable the `{feature}` Cargo feature")]
18 BackendNotCompiled {
19 backend: &'static str,
21 feature: &'static str,
23 },
24
25 #[error("backend `{0}` is not available in the linked MNN library")]
27 BackendUnavailable(&'static str),
28
29 #[error("failed to read model `{path}`: {source}")]
31 ModelRead {
32 path: PathBuf,
34 #[source]
36 source: std::io::Error,
37 },
38
39 #[error("MNN operation `{operation}` failed: {message}")]
41 Native {
42 operation: &'static str,
44 message: String,
46 },
47
48 #[error("duplicate {kind} tensor `{name}`")]
50 DuplicateTensor {
51 kind: &'static str,
53 name: String,
55 },
56
57 #[error("missing input tensor `{0}`")]
59 MissingInput(String),
60
61 #[error("unknown {kind} tensor `{name}`")]
63 UnknownTensor {
64 kind: &'static str,
66 name: String,
68 },
69
70 #[error("tensor `{name}` shape mismatch: expected {expected:?}, got {actual:?}")]
72 ShapeMismatch {
73 name: String,
75 expected: Vec<i32>,
77 actual: Vec<usize>,
79 },
80
81 #[error("tensor `{name}` data length mismatch: shape needs {expected} values, got {actual}")]
83 DataLengthMismatch {
84 name: String,
86 expected: usize,
88 actual: usize,
90 },
91
92 #[error("tensor `{name}` shape is too large")]
94 ShapeOverflow {
95 name: String,
97 },
98
99 #[error("tensor `{name}` shape is unresolved; supply concrete input dimensions")]
101 UnresolvedShape {
102 name: String,
104 },
105
106 #[error("tensor `{name}` has invalid dimensions {shape:?}")]
108 InvalidShape {
109 name: String,
111 shape: Vec<usize>,
113 },
114
115 #[error("failed to prepare cache directory `{path}`: {source}")]
117 CacheDirectory {
118 path: PathBuf,
120 #[source]
122 source: std::io::Error,
123 },
124
125 #[error("model request queue is full")]
127 QueueFull,
128
129 #[error("inference request cancelled")]
131 Cancelled,
132
133 #[error("inference deadline exceeded")]
135 DeadlineExceeded,
136
137 #[error(
139 "requested {requested} CPU threads, but MNN provides {effective}; initialize the largest thread budget first"
140 )]
141 ThreadCountLimited {
142 requested: usize,
144 effective: usize,
146 },
147
148 #[error("model worker stopped unexpectedly")]
150 WorkerStopped,
151
152 #[error("model worker panicked during startup")]
154 WorkerPanicked,
155
156 #[error("process-wide MNN execution gate is poisoned")]
158 ExecutionGatePoisoned,
159}