Struct MemoryAgent 

pub struct MemoryAgent {
    pub config: AgentConfig,
    pub state: AgentState,
    /* private fields */
}

Autonomous memory management agent.

Call MemoryAgent::tick at the desired cadence to run one full observe→decide→act cycle. The agent tracks its own state between calls.

Fields

config: AgentConfig

Current configuration (mutable via MemoryAgent::configure).

state: AgentState

Live operational state.

Implementations

impl MemoryAgent

pub fn new(config: AgentConfig) -> Self

Create a new agent with the given configuration. The agent starts in a stopped state (running = false).

pub fn start(&mut self)

Mark the agent as running and record the start time for uptime tracking.

pub fn stop(&mut self)

Mark the agent as stopped. The accumulated state is preserved.

pub fn is_running(&self) -> bool

Returns true if the agent has been started and not yet stopped.

pub fn tick(&mut self, conn: &Connection) -> Result<CycleResult>

Execute one observe→decide→act cycle.

Phase 1 — Observe

• Run MemoryGardener in dry-run mode to score memories and identify prune / merge / archive candidates.
• Run GapDetector to surface knowledge gaps and acquisition hints.

Phase 2 — Decide

Actions are prioritised as:

1. Urgent prunes (garden score critically low)
2. Merge candidates
3. Archive candidates
4. Garden run (if should_garden())
5. Acquisition suggestions from gap analysis

The total is capped at config.max_actions_per_cycle.

Phase 3 — Act

The actions list is returned. No DB writes are made by this method. The caller (MCP handler) decides whether to apply them.

State Update

AgentState.cycles is incremented and timestamps are refreshed.

pub fn should_garden(&self) -> bool

Returns true if enough time has passed since the last garden run to justify running another one.

• If the garden has never run, returns true.
• Otherwise, returns true only if garden_interval_secs seconds have elapsed since state.last_garden_at.

pub fn metrics(&self) -> AgentMetrics

Compute current performance metrics from accumulated state.

pub fn configure(&mut self, new_config: AgentConfig)

Replace the current configuration.

Changes take effect on the next call to tick().

pub fn status(&self) -> AgentState

Return a snapshot of the current agent state.