v6 library

An adapter node for governed agent generation (libs/v6/isis-agent-gen/src/index.ts). It expands authored premises into discovery seed manifests for the Wilds/Commons zones with typed personality archetypes (expandDiscoveryPremise, generateDiscoverySeedManifest, validateDiscoverySeedManifest), runs the player-raising ("rearing") lifecycle as a tick loop with value-shift evaluation (startRearingPeriod → runRearingPeriodTick → completeRearingPeriod, evaluateRearingValueShift), and records a verifiable foundry provenance record (recordFoundryProvenance, validateFoundryProvenanceRecord) plus creator royalty routing through Aje (routeCreatorRoyaltiesViaAje). It is the generation engine @oshun/egbe-studio drives.

A compact (~615-line) adapter policy gate (libs/v6/isis-behavior-policy/src/index.ts). evaluateIsisBehaviorPolicy runs four check kinds over a proposed agent output — persona-policy, personal-consistency, crisis-aware, and minor-protection — and returns an approved/rejected decision with reasons, backed by helpers that detect an agent claiming to be a real human (findAgentHumanIdentityClaim), find crisis-unsafe content (findCrisisUnsafeContent), and confirm supportive crisis routing (hasSupportiveCrisisRouting). runIsisSafetyEval batches the gate into a scored eval. This is the isis stage of the cognition-stack pipeline.

The adapter node implementing an Ori's three memory scopes (libs/v6/memory-iris-agent/src/index.ts): episodic, semantic, and reflective. Episodic memories carry a real exponential salience decay with a halfLifeMs and reinforcement-on-reuse/reflection (createEpisodicMemoryStore, reinforceEpisodicMemory, effectiveEpisodicSalienceBasisPoints combining decayedSalienceBasisPoints + reinforcementBasisPoints). Semantic memory is distilled from episodes and used to rank candidate actions (distillSemanticMemoriesFromEpisodes, rankActionsWithSemanticMemory); the reflective tick (runReflectiveMemoryTick) feeds higher-order ranking. Consent is first-class: iris-memory-consent-scope, requestEpisodicMemoryDeletion, and applyAgentMemoryForgiveness.

A focused (~1,100-line) adapter node — the cognition dispatch + speech seam (libs/v6/psyche-agent/src/index.ts). dispatchPsycheCognition produces a typed v6.psyche-agent.cognition-response.1; routePsycheConversationTurn turns a cognition response into a spoken reply, including a local TTS provider (v6-local-tts) and a phoneme→viseme lip-sync map (PsycheLipSyncViseme: rest/A/E/I/O/U/MBP/FV/L/WQ/CDGKNRST), gated by a spoken-reply-ready vs budget-exceeded status. The ...ViaGateway variants route through the injected @iris/agents-core CognitionGateway (the comment at index.ts:272 notes the real gateway is assignable to the structural handle). This is the psyche stage of the cognition pipeline.

The adapter node for factual grounding and cultural review (libs/v6/sophia-agent-grounding/src/index.ts, ~620 lines). groundAgentClaimsWithSophia checks each claim (fact/opinion/backstory) against supplied evidence sources with authority weighting and returns grounded vs unsupported; runSophiaGroundingEval scores it as an eval. It also runs a locale cultural-backstory review across roles (source-grounding, local-cultural-adapter, community-advisor) and locales (en-US, es-ES, yo-NG) via runLocaleCulturalBackstoryReview. This is the sophia stage that runs before an Ori's output is dispatched, keeping asserted backstory from drifting into fabrication.

The bridge node for cross-realm incarnation (libs/v6/aye-bridge/src/index.ts). It mints scoped, data-minimised "passports" from an Ori's service record (mintPassportFromOriService, minimisePassportForDestination) and adapts them into the earlier V-projects through a destination-adapter registry — v2-fighter-adapter, v3-citizen-adapter, v4-operator-adapter, v5-companion-adapter — then runs the full round trip (startIncarnationRoundTrip, writeIncarnationJournalBackToOri) with fault-injection, duplicate-incarnation guards, and Isis/Lilith policy and minor-protection gates (evaluateIncarnationGovernance). This is how an agent leaves Orun, acts in another realm, and returns with a journal delta.

The communication node — voice/agentic control of objectives (libs/v6/vac-intent/src/index.ts). It models the full voice pipeline with a sub-400ms ack budget (VAC_PARSED_INTENT_ACK_BUDGET_MS, VAC_DEFAULT_STAGE_LATENCIES_MS for capture/gateway/ASR/parser/ack), turning an ASR transcript into a structured objective through an LLM intent-grammar function call (buildVacIntentGrammarFunctionSchema, buildVacIntentGrammarFunctionCall, validateVacIntentGrammarFunctionCall, parseVacTranscriptToObjective). Objectives carry an autonomy mode (direct-tether/brief/standing-intent/free) and a status lifecycle (draft→confirmed→accepted/refused→active→completed/…), with a confirmation preview, standing-objective eligibility check, and negotiation routing (runVacVoiceIntentPipeline, routeVacNegotiation). @oshun/agent-behavior consumes these objectives to drive agent goals.

The governance node for agent welfare and steward conduct (libs/v6/lilith-agent-welfare/src/index.ts). Its founding principle is "steward-not-owner" (evaluateEgbeStewardNotOwnerRequest, with a fuzz harness runEgbeStewardNotOwnerFuzz): a player stewards an Ori but cannot coerce or mistreat it. It opens welfare cases and computes welfare signals (createEgbeWelfareCase, computeEgbeWelfareSignals, triggerEgbeLilithReview), routes player crisis conversations and minor-player constrained mode by composing @iris/emotional-ethics createCrisisProtocol (routeEgbePlayerCrisisConversation, runEgbeMinorPlayerConstrainedMode), and surfaces steward-conduct investigations with full cognition call logs (openEgbeStewardConductInvestigation, surfaceEgbeConductClaimsWithFullCallLog) plus batched OTel welfare telemetry.

The legacy layer — the end-of-life and lineage system (libs/v6/ereshkigal-legacy/src/index.ts). It evaluates the three exit paths an Ori can take — evaluateDeparture, evaluateTranscendence (elder/ancestor-grove mentor state), and evaluateDeath (with explicit minor-death-protection) — and maintains the walkable ancestor-grove lineage graph (evaluateAncestorGrove). Capabilities include grief-Ori writes, Yemaya remembrance rendering, and lineage-story propagation, so a character's departure leaves continuity in the world rather than a hard delete. Bond facets (reliability/respect/care/alignment) drive the memorialization weighting.

The memory-layer event-sourced identity model (libs/v6/ori-model/src/index.ts plus a ~1,900-line Rust crate). An Ori is a log of typed events (ORI_EVENT_TYPES: Born, Discovered, MemoryFormed, Reflected, RelationshipChanged, ValueShifted, Incarnated, Departed, Transcended, Died, …) folded into a projection (createOriEventLog, applyOriEventToProjection, rebuildOriProjection) with periodic snapshots every ORI_PROJECTION_SNAPSHOT_INTERVAL (512) events and a 1s load budget. It uses vector clocks for distributed conflict resolution (compareOriVectorClocks, resolveOriEventConflicts), bounds trait drift per season (ORI_TRAIT_DRIFT_MAX_PER_SEASON_BASIS_POINTS), implements a cognition cache keyed by a material fingerprint with explicit invalidation (buildOriMaterialFingerprint, resolveOriRoutineCognitionFromCache, createOriCognitionCacheInvalidationEventDraft), and renders a dossier (renderOriDossier). This is the canonical "what an Ori is" store the kernel loads.

The mind-layer behavior engine (libs/v6/agent-behavior/src/index.ts plus a ~2,600-line Rust crate at rust/src/lib.rs). It runs Ori in one of two modes — DeterministicFallback behavior-tree/HTN execution when no cognition slot is available, or ScheduledCognition when Moirai grants one (execution_mode(cognition_available) in Rust) — and owns goal-arc advancement, life-arc progression, and crossroads resolution (advanceAgentOwnedGoalArcSession, advanceAgentLifeArc, resolveAgentCrossroads). It is the consumer of @oshun/egbe-protocol squad comms and @oshun/vac-intent objectives (assignObjectiveFromVacTranscript), imported through local external-*.d.ts shims to avoid the buildable-lib TS6059 trap. Includes a minor-protection gate (evaluateMinorCodedAgentProtection).

The mind-layer dialogue orchestration pipeline (libs/v6/cognition-stack/src/index.ts). It defines the Clotho/Lachesis/Atropos tiers and four cognition modes (dialogue/decision/reflection/summary), bounds context assembly with explicit CognitionContextAssemblyLimits (assembleCognitionContext), then chains the governed pipeline: ground with Sophia → dispatch with Psyche → gate with Isis → commit (groundCognitionRequestWithSophia, dispatchCognitionWithPsyche, gateCognitionOutputWithIsis, commitCognitionOutput). The sibling domains are injected as structural handles (input.sophia / input.psyche / input.isis), not imported, so the buildable lib stays free of source cross-imports. A separate localized-dialogue-gateway path (generateLocalizedAgentDialogueViaGateway, createGatewayLocalizedDialogueGenerator) wires the @iris/agents-core gateway for localized output.

The mind-layer cognition scheduler and the central performance kernel (libs/v6/moirai-kernel/src/index.ts plus the ~5,700-line Rust crate at rust/src/lib.rs, which depends on the egbe-protocol and ori-model crates). It enforces the three-tier token economy — Clotho active-minute (50k), Lachesis reflection (10k) and game-minute (1.2k), Atropos game-day (15k) budgets, with a solo-world hard cap (MOIRAI_SOLO_WORLD_COGNITION_CAP_TOKENS_PER_REAL_HOUR) — via evaluateMoiraiCognitionBudget, scheduleMoiraiCognitionDispatch, and simulateWorstCaseSoloWorldCognitionBudget. It does deterministic model right-sizing/routing (selectMoiraiModelRoute, fingerprintMoiraiModelRoutingConfig) and keeps an auditable cognition-call ledger (buildMoiraiCognitionCallAuditLog). Its cognition-gateway-mount.ts is the actionable seam that mounts the shared Iris CognitionGateway (injected structurally; the real HTTP/engine host stays [~], as documented in the file header).

The protocol spine and the largest TS node (~6,800 lines) — the Egbe ground wire format. The schema is a real protobuf definition (proto/oshun/v6/egbe/v1/egbe.proto: ~34 messages and 10 enums covering AgentState, PerceptionBatch, ActionBatch, PresencePacket, SquadCommsMessage, WorldEvent, version negotiation, and client/server envelopes), code-generated into TS (src/generated/...), C++ for UE (ue/generated/...egbe.pb.cc/.h), and a prost Rust crate (rust/src/lib.rs). src/index.ts adds the hand-written protocol layer: version handshake (protocolV600/protocolV610, negotiateProtocolHandshake), canonicalisation + encode/decode + delta projection codecs (encodeAgentStateDelta, applyAgentStateDelta, roundTripPerceptionBatchToActionBatch), squad-comms routing (routeSquadCommsMessage, emitSquadStatusReport, …), an Aje commerce catalog (buildEgbeAjeCommerceCatalog, authorizeEgbeAjePurchaseViaAje), and a replication bandwidth guard (validateReplicationBandwidth) against the 256 kbps / 20 Hz / 32-agent caps declared in the Rust crate.

The story layer — the chronicler (libs/v6/clio-story/src/index.ts, with a dedicated clio-narration.spec.ts). It ranks an Ori's lived events by significance against a curated rubric (rankChronicleEventsBySignificance), builds returning-player chronicles with a token/latency budget (createReturningPlayerChronicle, and the async model-backed createReturningPlayerChronicleNarrated), surfaces emergent/pre-conclusion arc prompts (surfaceEmergentArcPrompts), and exports long-form "Book of the Ori" biographies (generateBookOfTheOri) including narrative reconciliation of unorderable events (reconcileOriConflictNarrative). It carries real chronicle budget constants (e.g. CHRONICLE_READY_BUDGET_MS = 3_500) and a Tier-2 density backfill path.

The studio layer — the creator/operator tooling (libs/v6/egbe-studio/src/index.ts). It implements editor state machines and patch/publish flows for agent dossiers, ground (district) authoring, and scenario authoring (createEgbeAgentDossierEditorState, promoteEgbeGroundAuthoring, createEgbeScenarioAuthoringState with a evaluateEgbeScenarioMinorProtection gate), plus operator consoles for the foundry generation queue, commons moderation, incarnation governance, capacity, and takedowns (createEgbeOperatorSurface, performEgbeOperatorSurfaceAction). It composes @oshun/isis-agent-gen for the generation/provenance side (generateDiscoverySeedManifest, recordFoundryProvenance) so authored content carries a provenance bundle.

A small (~260-line) surface node (libs/v6/egbe-engine-web-fallback/src/index.ts) for low-end clients. It produces a reduced-fidelity render manifest for the orun-tier2-grove scene (createOrunFallbackSceneManifest), selects a renderer budget that falls back WebGPU → WebGL2 (selectFallbackRendererBudget, with a webgl2-after-webgpu-unavailable backend state), and caps agent density for the Tier-2 budget (selectTier2AgentDensityBudget). It is the honest "degraded but playable" twin of the pixel-streaming surface, with hard FallbackRendererBudget caps (target FPS, max visible agents, baked lighting) rather than full fidelity.

A focused (~720-line) surface node for cloud-rendered play (libs/v6/egbe-web-pxstream/src/index.ts). It builds Unreal Pixel-Streaming launch and WebRTC player configs (createPixelStreamingLaunchConfig), routes match/signalling sessions (the V6_PIXEL_STREAMING_MATCH_PATH / ...SIGNALLING_PATH API paths, matchEgbePixelStreamingSession), and enforces a first-frame SLA via telemetry (evaluateFirstFrameTelemetry against DEFAULT_FIRST_FRAME_BUDGET_MS = 8000). It exposes a streaming client and an Epic-adapter factory (createEgbePixelStreamingClient, createEpicEgbePixelStreamingAdapter) covering H264/AV1 and a degraded status.