Struct CaptureRequest 

pub struct CaptureRequest {
    pub content: String,
    pub namespace: Namespace,
    pub domain: Domain,
    pub tags: Vec<String>,
    pub source: Option<String>,
    pub skip_security_check: bool,
    pub ttl_seconds: Option<u64>,
    pub scope: Option<DomainScope>,
    pub group_id: Option<String>,
}

Request to capture a new memory.

Fields

content: String

The content to capture.

namespace: Namespace

Target namespace for the memory.

domain: Domain

Target domain for the memory.

tags: Vec<String>

Optional tags for categorization.

source: Option<String>

Optional source reference.

skip_security_check: bool

Whether to skip security filtering.

ttl_seconds: Option<u64>

Optional time-to-live in seconds.

When set, expires_at is calculated as created_at + ttl_seconds. None means no expiration (memory lives until manually deleted).

scope: Option<DomainScope>

Target storage scope for the memory.

• Project/User: Stored in user-local index (default)
• Org: Stored in organization-shared index (requires org feature enabled)

Default: None (uses context-appropriate scope based on git status)

group_id: Option<String>

Optional group identifier for group-scoped memories.

When set, the memory is associated with a specific group and requires write permission to that group. Group-scoped memories are visible to all group members during recall.

Implementations

impl CaptureRequest

pub fn new(content: impl Into<String>) -> Self

Creates a new capture request with the given content.

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

Sets the namespace.

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

Sets the domain.

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

Adds a tag.

pub fn with_source(self, source: impl Into<String>) -> Self

Sets the source reference.

pub const fn with_ttl(self, ttl_seconds: u64) -> Self

Sets the time-to-live in seconds.

The memory will expire after this duration from creation time. None means no expiration.

pub const fn with_scope(self, scope: DomainScope) -> Self

Sets the storage scope for the memory.

• Project/User: Stored in user-local index
• Org: Stored in organization-shared index

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

Sets the group identifier for group-scoped memories.

When set, the memory is associated with a specific group and requires write permission to that group.

Trait Implementations

impl Clone for CaptureRequest

fn clone(&self) -> CaptureRequest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CaptureRequest

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

Formats the value using the given formatter.

impl Default for CaptureRequest

fn default() -> CaptureRequest

Returns the “default value” for a type.