use std::collections::hash_map::DefaultHasher;
use std::hash::Hasher;
pub type Result<T> = std::result::Result<T, AiError>;
#[derive(Debug, thiserror::Error)]
pub enum AiError {
#[error("missing DeepSeek API key: set DEEPSEEK_API_KEY or provide one via AiConfig")]
MissingApiKey,
#[error("invalid configuration: {0}")]
InvalidConfig(String),
#[error("failed to serialize an input parameter to JSON: {0}")]
InputSerialization(String),
#[error("unsupported output schema: {0}")]
UnsupportedSchema(String),
#[error("http error after {attempts} attempt(s): {summary}")]
Http {
attempts: u32,
summary: String,
},
#[error("api error (status: {status:?}, request id: {request_id:?}): {summary}")]
Api {
status: Option<u16>,
request_id: Option<String>,
summary: String,
},
#[error("empty model content (request id: {request_id:?})")]
EmptyContent {
request_id: Option<String>,
},
#[error(
"model output is not valid JSON (request id: {request_id:?}, {content_len} bytes, hash {content_hash:#x}): {summary}"
)]
JsonParse {
request_id: Option<String>,
content_len: usize,
content_hash: u64,
summary: String,
},
#[error(
"model output failed schema validation (request id: {request_id:?}, {content_len} bytes, hash {content_hash:#x}): {summary}"
)]
SchemaValidation {
request_id: Option<String>,
content_len: usize,
content_hash: u64,
summary: String,
},
#[error(
"model output passed schema validation but failed deserialization ({content_len} bytes, hash {content_hash:#x}): {summary}"
)]
OutputDeserialization {
content_len: usize,
content_hash: u64,
summary: String,
},
}
pub(crate) fn content_fingerprint(content: &str) -> u64 {
let mut hasher = DefaultHasher::new();
hasher.write(content.as_bytes());
hasher.finish()
}
pub(crate) fn summarize(message: &str, max_chars: usize) -> String {
let flattened: String = message.split_whitespace().collect::<Vec<_>>().join(" ");
let mut out: String = flattened.chars().take(max_chars).collect();
if flattened.chars().count() > max_chars {
out.push('…');
}
out
}