Struct ThoughtQuery 

pub struct ThoughtQuery {

    pub thought_types: Option<Vec<ThoughtType>>,
    pub roles: Option<Vec<ThoughtRole>>,
    pub agent_ids: Option<Vec<String>>,
    pub agent_names: Option<Vec<String>>,
    pub agent_owners: Option<Vec<String>>,
    pub tags_any: Vec<String>,
    pub concepts_any: Vec<String>,
    pub text_contains: Option<String>,
    pub min_importance: Option<f32>,
    pub min_confidence: Option<f32>,
    pub since: Option<DateTime<Utc>>,
    pub until: Option<DateTime<Utc>>,
    pub limit: Option<usize>,
}

Retrieval filter for semantic memory queries.

ThoughtQuery lets callers ask for slices of memory without replaying the entire chain.

ThoughtQuery is read-only. It does not create or modify thoughts. Its job is to select already-committed Thought records by semantic type, operational role, agent identity, tags, concepts, text, confidence, importance, and time range.

The relationship between the three main data shapes is:

• ThoughtInput: proposed memory to append
• Thought: committed durable memory
• ThoughtQuery: retrieval filter over committed memory

Example

use thoughtchain::{ThoughtQuery, ThoughtType};

let query = ThoughtQuery::new()
    .with_types(vec![ThoughtType::Decision, ThoughtType::Constraint])
    .with_min_importance(0.8);

assert!(query.min_importance.is_some());

Fields

thought_types: Option<Vec<ThoughtType>>

Semantic thought types to match.

roles: Option<Vec<ThoughtRole>>

Operational roles to match.

agent_ids: Option<Vec<String>>

Agent ids to match.

agent_names: Option<Vec<String>>

Agent names to match.

agent_owners: Option<Vec<String>>

Agent owners to match.

tags_any: Vec<String>

Match if any tag matches.

concepts_any: Vec<String>

Match if any concept matches.

text_contains: Option<String>

Text filter applied to content, tags, and concepts.

min_importance: Option<f32>

Minimum importance threshold.

min_confidence: Option<f32>

Minimum confidence threshold.

since: Option<DateTime<Utc>>

Start of the timestamp window, inclusive.

until: Option<DateTime<Utc>>

End of the timestamp window, inclusive.

limit: Option<usize>

Maximum number of thoughts to return.

Implementations

impl ThoughtQuery

pub fn new() -> Self

Create an empty query that matches every thought.

pub fn with_types(self, thought_types: Vec<ThoughtType>) -> Self

Limit matches to the provided semantic thought types.

pub fn with_roles(self, roles: Vec<ThoughtRole>) -> Self

Limit matches to the provided thought roles.

pub fn with_agent_ids<I, S>(self, agent_ids: I) -> Self

where I: IntoIterator<Item = S>, S: Into<String>,

Limit matches to the provided agent identifiers.

pub fn with_agent_names<I, S>(self, agent_names: I) -> Self

where I: IntoIterator<Item = S>, S: Into<String>,

Limit matches to the provided agent names.

pub fn with_agent_owners<I, S>(self, agent_owners: I) -> Self

where I: IntoIterator<Item = S>, S: Into<String>,

Limit matches to the provided agent owner labels.

pub fn with_tags_any<I, S>(self, tags: I) -> Self

where I: IntoIterator<Item = S>, S: Into<String>,

Match thoughts that have at least one of the provided tags.

pub fn with_concepts_any<I, S>(self, concepts: I) -> Self

where I: IntoIterator<Item = S>, S: Into<String>,

Match thoughts that have at least one of the provided concepts.

pub fn with_text(self, text: impl Into<String>) -> Self

Match thoughts whose content, tags, or concepts contain the provided text.

pub fn with_min_importance(self, importance: f32) -> Self

Only match thoughts whose importance is at least this value.

pub fn with_min_confidence(self, confidence: f32) -> Self

Only match thoughts whose confidence is at least this value.

pub fn with_since(self, since: DateTime<Utc>) -> Self

Only match thoughts at or after the given timestamp.

pub fn with_until(self, until: DateTime<Utc>) -> Self

Only match thoughts at or before the given timestamp.

pub fn with_limit(self, limit: usize) -> Self

Limit the number of returned thoughts.

Trait Implementations

impl Clone for ThoughtQuery

fn clone(&self) -> ThoughtQuery

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ThoughtQuery

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for ThoughtQuery

fn default() -> ThoughtQuery

Returns the “default value” for a type.