Struct PersonaGenerator 

pub struct PersonaGenerator<'a> { /* private fields */ }

The persona-generation engine.

Constructed per call (cheap — just holds references). Generation is idempotent in the sense that calling generate twice writes two distinct rows with consecutive version numbers; the substrate never overwrites a persona in place so audit trails stay intact.

Implementations

impl<'a> PersonaGenerator<'a>

pub fn new( conn: &'a Connection, llm: &'a dyn AutonomyLlm, signer: Option<&'a AgentKeypair>, config: PersonaConfig, ) -> Self

Construct a fresh generator.

pub fn generate( &self, entity_id: &str, namespace: &str, ) -> Result<Persona, PersonaError>

Generate a fresh Persona for entity_id in namespace.

Steps

1. Validate entity_id (non-empty, within identity bounds) and namespace.
2. Load up to config.max_reflection_sources Reflection-kind memories from namespace referencing the entity.
3. Refuse with PersonaError::NoReflections when the pool is empty — a Persona without sources has no audit trail.
4. Resolve the next version (max existing + 1, defaulting 1).
5. Call the curator (AutonomyLlm::summarize_memories) over the sources to produce the Markdown body.
6. Insert a MemoryKind::Persona memory row with entity_id + persona_version populated and metadata carrying the persona envelope.
7. Write one derives_from memory_link from the persona row to each source reflection.
8. Append a persona_generated row to signed_events.

Errors

One of the PersonaError variants. The DB-level errors are the only ones without a structured payload — every other variant carries enough context for a clean operator message.

pub fn generate_cross_namespace( &self, entity_id: &str, target_namespace: &str, ) -> Result<Persona, PersonaError>

v0.7.0 issue #848 — cross-namespace persona generation.

Equivalent to Self::generate except the source-reflection scan is broadened to every namespace the substrate stores. The new persona row lands in target_namespace (callers typically pass "global" so subsequent memory_persona(entity_id) reads have a deterministic landing zone). Use this when an NHI agent has spread its reflections across multiple namespaces (e.g. global/policies, ai-memory/v0.7.0-nhi-testing, project buckets) and needs a single Persona that aggregates the full identity arc.

Errors

Same envelope as Self::generate. When zero matching reflections exist in ANY namespace, the NoReflections.namespace field is the CROSS_NAMESPACE_SENTINEL string.