weavatrix-memory 0.3.2

Event-sourced bitemporal evidence memory and budgeted context retrieval for coding agents
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

use super::{ExtractionInput, ExtractionOutput};
use crate::error::MemoryError;
use std::{error::Error, fmt};

#[derive(Debug, Clone, PartialEq, Eq)]
pub struct ExtractionError {
    pub provider: String,
    pub message: String,
}

impl ExtractionError {
    #[must_use]
    pub fn new(provider: impl Into<String>, message: impl Into<String>) -> Self {
        Self {
            provider: provider.into(),
            message: message.into(),
        }
    }
}

impl fmt::Display for ExtractionError {
    fn fmt(&self, formatter: &mut fmt::Formatter<'_>) -> fmt::Result {
        write!(
            formatter,
            "extraction provider {} failed: {}",
            self.provider, self.message
        )
    }
}

impl Error for ExtractionError {}

impl From<ExtractionError> for MemoryError {
    fn from(value: ExtractionError) -> Self {
        Self::Extraction {
            provider: value.provider,
            message: value.message,
        }
    }
}

/// Converts source material into typed mentions and relations.
///
/// Providers may wrap AST parsers, issue trackers, language models, or future
/// Weavatrix search packages. The memory core owns validation, entity linking,
/// provenance, and event creation.
pub trait ExtractionProvider: Sync {
    fn name(&self) -> &str;

    /// Extracts candidates without mutating memory.
    ///
    /// # Errors
    ///
    /// Returns a provider-labelled failure. The engine rejects failures whose
    /// provider identity does not match [`Self::name`].
    fn extract(&self, input: &ExtractionInput) -> Result<ExtractionOutput, ExtractionError>;
}