4everCraft Mod/com.evermod.lorekeeper/LorekeeperAiService

LorekeeperAiService

Service for generating AI-powered lore summaries and interview reactions.

Supports multiple AI providers with fallback capability. Generates weekly news summaries, historical narratives, and in-character interview responses.

Types

InterviewTopicFollowUpRequest

data class InterviewTopicFollowUpRequest(val playerName: String, val topicTitle: String, val previousQuestion: String, val answer: String, val triggerHint: String?, val memoryPackets: List<LorekeeperAiService.LoreTalkMemoryPacket>)

Request payload for AI-generated per-topic interview follow-up prompts.

InterviewTopicOpenersRequest

data class InterviewTopicOpenersRequest(val playerName: String, val previousInterviewEntries: List<LoreStorage.LoreEntry>, val fallbackQuestions: List<String>, val topicCount: Int, val triggerHint: String?, val memoryPackets: List<LorekeeperAiService.LoreTalkMemoryPacket>)

Request payload for AI-generated interview topic opener questions.

LoreTalkMemoryPacket

data class LoreTalkMemoryPacket(val source: String, val timestamp: Long, val evidence: String, val tags: List<String> = emptyList(), val names: List<String> = emptyList())

Canonical interpreted memory packet injected into the Lorekeeper talk prompt.

LoreTalkPromptContext

data class LoreTalkPromptContext(val topic: String, val recentTranscriptLines: List<String>, val playerMessage: String, val recentLoreEntries: List<LoreStorage.LoreEntry> = emptyList(), val recentInterviewEntries: List<LoreStorage.LoreEntry> = emptyList(), val historySummary: String? = null, val reputationContextLines: List<String> = emptyList(), val memoryPackets: List<LorekeeperAiService.LoreTalkMemoryPacket> = emptyList())

Context bundle used to generate a Lorekeeper talk reply prompt.

LoreTalkReviewAssessment

data class LoreTalkReviewAssessment(val usefulnessScore: Int, val civilityScore: Int, val summary: String)

Structured score payload for post-talk contribution review.

Properties

circuitBreaker

val circuitBreaker: CircuitBreaker

Circuit breaker for the Lorekeeper HTTP AI client.

rateLimiter

val rateLimiter: AiRateLimiter

Rate limiter for the Lorekeeper HTTP AI client.

Functions

canAutoRequestWeeklySummaryNow

fun canAutoRequestWeeklySummaryNow(weekNumber: Long, hasEntries: Boolean): Boolean

Returns true when auto-generation can issue a fresh weekly AI attempt right now.

generateBiographySummary

fun generateBiographySummary(context: LorekeeperReputationProfileService.ReputationBookContext, alignment: LorekeeperReputationProfileService.ReputationAlignment): String?

Generates a player biography summary grounded in archived evidence.

generateInterviewFollowUpQuestions

fun generateInterviewFollowUpQuestions(playerName: String, previousInterviewEntries: List<LoreStorage.LoreEntry>, fallbackQuestions: List<String>, questionCount: Int): List<String>?

Generates follow-up interview questions using prior player interview history.

generateInterviewReaction

fun generateInterviewReaction(playerName: String, question: String, answer: String): String?

Generates an AI-powered interview reaction to a player's answer.

generateInterviewTopicFollowUpQuestion

fun generateInterviewTopicFollowUpQuestion(request: LorekeeperAiService.InterviewTopicFollowUpRequest): String?

Generates one targeted follow-up question for the current interview topic.

generateInterviewTopicOpeners

fun generateInterviewTopicOpeners(request: LorekeeperAiService.InterviewTopicOpenersRequest): List<String>?

Generates opening prompts for a multi-topic interview session.

generateInvestigationQuestions

fun generateInvestigationQuestions(targetPlayerName: String, reporterName: String, reportedQuestion: String, reportedAnswer: String): List<String>?

Generates up to two investigation questions for a mentioned player.

generateLoreTalkAssessment

fun generateLoreTalkAssessment(playerName: String, topic: String, transcriptLines: List<String>, archivedSummary: String): LorekeeperAiService.LoreTalkReviewAssessment?

Reviews a completed talk and returns structured usefulness/civility scoring.

generateLoreTalkReply

fun generateLoreTalkReply(playerName: String, context: LorekeeperAiService.LoreTalkPromptContext): String?

Generates a conversational Lorekeeper reply during a free-form talk session.

generateLoreTalkSummary

fun generateLoreTalkSummary(playerName: String, topic: String, transcriptLines: List<String>): String?

Generates a concise archival gist for a completed free-form talk session.

generateQualityAssessment

fun generateQualityAssessment(title: String, author: String, content: String): String?

Generates a JSON quality assessment for a submitted lore book.

generateRumor

fun generateRumor(playerName: String, interviewEntries: List<LoreStorage.LoreEntry>, submittedBooks: List<LoreStorage.SubmittedBook>): String?

Generates a short in-world rumor line from recent interview and submitted-book sources.

getOrCreateHistorySummary

fun getOrCreateHistorySummary(server: MinecraftServer, entries: List<LoreStorage.LoreEntry>): String?

Gets or creates an AI-generated history summary from all lore entries.

getOrCreateWeeklySummary

fun getOrCreateWeeklySummary(server: MinecraftServer, weekNumber: Long, entries: List<LoreStorage.LoreEntry>, bypassRetryCooldown: Boolean = false): String?

Gets or creates an AI-generated weekly summary for the given week.

isWeeklyRetryExhausted

fun isWeeklyRetryExhausted(weekNumber: Long): Boolean

Returns true when weekly generation has exhausted automatic retries for the week.

isWeeklySummaryCoolingDown

fun isWeeklySummaryCoolingDown(weekNumber: Long): Boolean

Returns true when weekly generation is currently cooling down before another retry.

isWeeklySummaryInFlight

fun isWeeklySummaryInFlight(weekNumber: Long): Boolean

Returns true when a weekly summary request is actively in-flight.

polishSubmittedBook

fun polishSubmittedBook(title: String, author: String, content: String): String?

Rewrites a submitted book for resale by correcting grammar and adding a foreword.