Explain: shorter answers, streamed, remembered, and prepared for settings
ci / fork-checks (pull_request) Successful in 1m31s
ci / build (pull_request) Failing after 5m18s

ai-explain spec, amendment 1 (EX-22 to EX-28):
- answers are three or four sentences, max_tokens 160, cut at 700 chars;
- POST /api/explain streams the answer as server-sent events;
- each node remembers answers in memory (1,000, 24 h), keyed by the facts,
  prompt version and model, shared by server-level administrators;
- resources/explain/settings.json.gz ships answers for settings at their
  defaults, generated with prepare_setting_explanations (717 for 2026.9.27);
- the system prompt no longer carries the per-request marker, so a model
  server can reuse it;
- inbuxa:Explanation gains source, answeredAt and preparedFor.
This commit is contained in:
2026-09-26 16:11:43 -07:00
parent e50222d518
commit 7e7eca0883
12 changed files with 969 additions and 77 deletions
+17 -4
View File
@@ -10,6 +10,7 @@
//! EX-7), and how its answer is trimmed (EX-12). The server reads the data
//! and makes the call.
pub mod memory;
pub mod prompts;
pub mod schema;
pub mod status;
@@ -17,11 +18,11 @@ pub mod status;
use serde_json::Value;
use std::collections::BTreeMap;
/// The most an answer may generate (EX-12).
pub const MAX_TOKENS: u32 = 400;
/// The most an answer may generate (EX-12, as amended by EX-22).
pub const MAX_TOKENS: u32 = 160;
/// The longest answer returned, in characters (EX-12).
pub const MAX_ANSWER_CHARS: usize = 1_200;
/// The longest answer returned, in characters (EX-12, as amended by EX-22).
pub const MAX_ANSWER_CHARS: usize = 700;
/// The largest subject accepted, serialized (EX-8).
pub const MAX_SUBJECT_BYTES: usize = 16 * 1024;
@@ -83,6 +84,18 @@ pub enum Kind {
Setting,
}
impl Kind {
/// A stable name, part of the key an answer is remembered by (EX-24).
pub fn as_str(&self) -> &'static str {
match self {
Kind::DeliveryFailure => "DeliveryFailure",
Kind::SpamVerdict => "SpamVerdict",
Kind::Event => "Event",
Kind::Setting => "Setting",
}
}
}
impl Subject {
pub fn kind(&self) -> Kind {
match self {