Eve library

@v2/hathor-npc-adapter

Other

Revision 1

On this page

V2-side bridge from open-world encounter hooks to Hathor @hathor/llm-npc.

The adapter only accepts World Tour, Tekken Force, Devil Within, DJ street, MyCAREER backstage, and SC Chronicles overworld requests. Every request must set rollbackPolicy: "off-rollback-only" and deterministicGameplay: false; the bridge returns outputs on the v2.npc.off_rollback side channel with rollbackResultPolicy: "ignored_by_rollback".

The package does not place live LLM output in 1v1 rollback state. Match banter, intros, taunts, and win quotes continue to come from prebaked Hathor @hathor/lore-compiler banks.

Dialogue-like outputs are cached through V2NpcDialogueCache. The file-backed implementation writes JSON entries under V2/ue/Content/Generated/NPCDialogue/<mode>/<hook>/<hash-prefix>/<hash>.json, where <hash> is sha256(seed + "\n" + contextHash). The cache rationale is cross-platform consistency, cost containment, and repeatability for QA/content sign-off; it is not a replay-determinism mechanism.

Every dialogue response is validated before it is exposed or cached. The bridge requires the Hathor persona identity to match the requested NPC, recognizes only the declared emotion and intent vocabulary, bounds action identifiers, and requires memoriesTriggered to equal the retrieved-and-validated memory attribution. confidenceScore must exactly match the supplied calibrated confidence evidence, and an answered response must clear its abstention threshold. Abstentions cannot carry actions or triggered memories. Missing, foreign, malformed, or contradictory evidence fails closed as invalid_runtime_output.