Database-backed NPC mode is for large or concurrent populations that need precise queries, revision history, scoped runtime assembly, and durable learned memory while retaining recoverable file-first persona source.
Identity layers stay separate
- Reviewed persona template and immutable source revision.
- Population and stable logical NPC identity.
- Registered name and display label.
- Runtime instance and expiring process lease.
- UAI memory identity and configured durable-memory namespace.
- World, game, player, and session scope.
- Revision lineage and separately recorded runtime variance.
Source, projection, and learned memory
reviewed UAIX files -> validated immutable source-persona revision -> bounded runtime persona projection -> separately recorded runtime variance
game events -> episodic NPC memory -> reviewed semantic NPC memory
player/game/session context -> relationship and active-session memory
A player or session record cannot overwrite persona-global identity. Runtime variance may explain adaptation but cannot mutate the source revision. Source persona does not appear in learned-memory search unless the caller explicitly selects that record class.
Database authority
Name the database migration authority separately from task and integration authority. The database owns transactions and constraint enforcement. The portable package records public-safe identity and authority references, never raw database credentials.
Open the Database NPC setup mode.
Support boundary
Agent runtimes execute. UAIX records portable configuration, logical identity, authority boundaries, routing references, reviewed evidence, and offline continuity. Runtime systems retain authentication, credential verification, leases, queues, transactions, tool execution, database writes, and delivery readback. A missing-authority request is review-pending only and applies no grants.
Schemas and validation
- Advanced Multi-Agent Workload schema
- Reference workload example
- UAI-1 profile registry
- Swarm Readiness checklist