Struct SearchFilter 

pub struct SearchFilter {

    pub namespaces: Vec<Namespace>,
    pub domains: Vec<Domain>,
    pub statuses: Vec<MemoryStatus>,
    pub tags: Vec<String>,
    pub tags_any: Vec<String>,
    pub excluded_tags: Vec<String>,
    pub source_pattern: Option<String>,
    pub project_id: Option<String>,
    pub branch: Option<String>,
    pub file_path: Option<String>,
    pub created_after: Option<u64>,
    pub created_before: Option<u64>,
    pub min_score: Option<f32>,
    pub include_tombstoned: bool,
    pub entity_names: Vec<String>,
    pub group_ids: Vec<String>,
}

Filter criteria for memory search.

Fields

namespaces: Vec<Namespace>

Filter by namespaces.

domains: Vec<Domain>

Filter by domains.

statuses: Vec<MemoryStatus>

Filter by statuses.

tags: Vec<String>

Filter by tags (AND logic - must have ALL).

tags_any: Vec<String>

Filter by tags (OR logic - must have ANY).

excluded_tags: Vec<String>

Exclude memories with these tags.

source_pattern: Option<String>

Filter by source pattern (glob-style).

project_id: Option<String>

Filter by project identifier (normalized git remote URL).

branch: Option<String>

Filter by branch name.

file_path: Option<String>

Filter by file path (relative to repo root).

created_after: Option<u64>

Minimum creation timestamp.

created_before: Option<u64>

Maximum creation timestamp.

min_score: Option<f32>

Minimum similarity score (0.0 to 1.0).

include_tombstoned: bool

Include tombstoned memories (default: false).

entity_names: Vec<String>

Filter by entity names (memories mentioning these entities). Uses OR logic - matches memories mentioning ANY of the listed entities.

group_ids: Vec<String>

Filter by group identifiers (group-scoped memories). Uses OR logic - matches memories in ANY of the listed groups.

Implementations

impl SearchFilter

pub const fn new() -> Self

Creates an empty filter (matches all).

pub fn with_namespace(self, namespace: Namespace) -> Self

Adds a namespace filter.

pub fn with_domain(self, domain: Domain) -> Self

Adds a domain filter.

pub fn with_status(self, status: MemoryStatus) -> Self

Adds a status filter.

pub fn with_tag(self, tag: impl Into<String>) -> Self

Adds a tag filter (AND logic - must have ALL).

pub fn with_tag_any(self, tag: impl Into<String>) -> Self

Adds a tag filter (OR logic - must have ANY).

pub fn with_excluded_tag(self, tag: impl Into<String>) -> Self

Adds an excluded tag filter.

pub fn with_source_pattern(self, pattern: impl Into<String>) -> Self

Sets the source pattern filter (glob-style).

pub fn with_project_id(self, project_id: impl Into<String>) -> Self

Sets the project identifier filter.

pub fn with_branch(self, branch: impl Into<String>) -> Self

Sets the branch filter.

pub fn with_file_path(self, file_path: impl Into<String>) -> Self

Sets the file path filter.

pub const fn with_min_score(self, score: f32) -> Self

Sets the minimum score threshold.

pub const fn with_created_after(self, timestamp: u64) -> Self

Sets the created_after filter.

pub const fn with_created_before(self, timestamp: u64) -> Self

Sets the created_before filter.

pub const fn with_include_tombstoned(self, include: bool) -> Self

Includes tombstoned memories in results.

pub fn is_empty(&self) -> bool

Returns true if the filter is empty (matches all).

pub fn with_entity(self, entity: impl Into<String>) -> Self

Adds an entity name filter. Filters to memories mentioning this entity (OR logic with other entities).

pub fn with_entities( self, entities: impl IntoIterator<Item = impl Into<String>>, ) -> Self

Adds multiple entity name filters.

pub fn with_group_id(self, group_id: impl Into<String>) -> Self

Adds a group identifier filter.

Filters to memories belonging to this group (OR logic with other groups).

pub fn with_group_ids( self, group_ids: impl IntoIterator<Item = impl Into<String>>, ) -> Self

Adds multiple group identifier filters.

Trait Implementations

impl Clone for SearchFilter

fn clone(&self) -> SearchFilter

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SearchFilter

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

Formats the value using the given formatter.

impl Default for SearchFilter

fn default() -> SearchFilter

Returns the “default value” for a type.

impl From<&SearchFilter> for VectorFilter

fn from(filter: &SearchFilter) -> Self

Converts a SearchFilter to a VectorFilter, extracting only the fields applicable to vector search.

impl From<SearchFilter> for VectorFilter

fn from(filter: SearchFilter) -> Self

Converts to this type from the input type.