Trait Suggestor 

pub trait Suggestor: Send + Sync {
    // Required methods
    fn name(&self) -> &str;
    fn dependencies(&self) -> &[ContextKey];
    fn accepts(&self, ctx: &dyn Context) -> bool;
    fn execute(&self, ctx: &dyn Context) -> AgentEffect;
}

The core suggestor contract.

Every suggestor in the Converge ecosystem implements this trait — whether it wraps an LLM, a policy engine, an optimizer, or a simple rule.

The engine calls accepts() to determine eligibility, then execute() to collect effects. Effects are merged by the engine in deterministic order (sorted by suggestor name).

Thread Safety

Suggestors must be Send + Sync because the engine executes eligible suggestors in parallel (via Rayon). Suggestor state, if any, must be internally synchronized.

Required Methods

fn name(&self) -> &str

Human-readable name, used for ordering, logging, and provenance.

Must be unique within a convergence run. The engine sorts suggestors by name to ensure deterministic merge order.

fn dependencies(&self) -> &[ContextKey]

Context keys this suggestor reads from.

The engine uses this to determine when a suggestor becomes eligible: a suggestor is a candidate when at least one of its dependency keys has been modified since the last cycle.

fn accepts(&self, ctx: &dyn Context) -> bool

Pure predicate: should this suggestor execute given the current context?

Contract

• Must be pure: no side effects, no I/O, no state mutation.
• Must be deterministic: same context → same answer.
• Must check idempotency via context: look for your own contributions in context (both Proposals and target key), not internal flags.

fn execute(&self, ctx: &dyn Context) -> AgentEffect

Produce effects given the current context.

Contract

• Read-only: do not mutate context. Return effects instead.
• Effects are collected by the engine and merged after all eligible suggestors have executed.
• For LLM suggestors: emit ProposedFact to ContextKey::Proposals, not directly to the target key.

Implementations on Foreign Types

impl Suggestor for ReactOnceSuggestor

fn name(&self) -> &str

fn dependencies(&self) -> &[ContextKey]

fn accepts(&self, ctx: &dyn Context) -> bool

fn execute(&self, _ctx: &dyn Context) -> AgentEffect

impl Suggestor for SeedSuggestor

fn name(&self) -> &str

fn dependencies(&self) -> &[ContextKey]

fn accepts(&self, ctx: &dyn Context) -> bool

fn execute(&self, _ctx: &dyn Context) -> AgentEffect

impl Suggestor for ValidationAgent

fn name(&self) -> &str

fn dependencies(&self) -> &[ContextKey]

fn accepts(&self, ctx: &dyn Context) -> bool

fn execute(&self, ctx: &dyn Context) -> AgentEffect

Implementors