4 import redis
.asyncio
as redis
10 # --- CONFIGURATION ---
11 MAX_CONCURRENT_OLLAMA_REQUESTS
= 3
12 ALLOW_TEXT_EMOTES
= False
14 # =====================================================================
15 # 1. INITIALIZE VECTOR DATABASES (Lore & Episodic Memory)
16 # =====================================================================
17 print("Initializing ChromaDB Vector Databases...")
18 chroma_client
= chromadb
.PersistentClient(path
="./asl_vectordb")
21 lore_collection
= chroma_client
.get_or_create_collection(name
="world_lore")
23 # --- NEW: The Episodic Memory Database ---
24 memory_collection
= chroma_client
.get_or_create_collection(name
="episodic_memories")
25 memory_queue
= asyncio
.Queue()
27 if os
.path
.exists("asl_lore.md"):
28 if lore_collection
.count() == 0:
29 print("[VECTOR DB] Reading asl_lore.txt and vectorizing chunks...")
30 with open("asl_lore.txt", "r", encoding
="utf-8") as f
:
33 lore_chunks
= [chunk
.strip() for chunk
in raw_lore
.split('\n\n') if chunk
.strip()]
36 chunk_ids
= [f
"lore_{i}" for i
in range(len(lore_chunks
))]
37 lore_collection
.add(documents
=lore_chunks
, ids
=chunk_ids
)
38 print(f
"[VECTOR DB] Successfully stored {len(lore_chunks)} lore chunks!")
40 print("[WARNING] asl_lore.txt not found.")
42 semaphore
= asyncio
.Semaphore(MAX_CONCURRENT_OLLAMA_REQUESTS
)
45 # =====================================================================
46 # --- BACKGROUND MEMORY SUMMARIZER (The "Dream State") ---
47 # =====================================================================
48 async def memory_summarizer_worker(session
):
49 print("[BACKGROUND] Memory Summarizer Worker is active.")
51 job
= await memory_queue
.get()
52 session_id
= job
['session_id']
53 player_name
= job
['player_name']
54 npc_tag
= job
['npc_tag']
55 chat_log
= job
['chat_log']
57 prompt
= f
"Summarize the key events, facts, and the emotional tone of this conversation snippet between {player_name} and {npc_tag}. Keep it to 2 brief sentences in the past tense.\nConversation Log:\n{chat_log}"
60 print(f
"[MEMORY DB] Generating background memory for {player_name} and {npc_tag}...")
61 # We use /api/generate here because we just want a raw text summary, not a JSON macro
62 async with session
.post('http://localhost:11434/api/generate', json
={
70 result
= await response
.json()
71 summary
= result
['response'].strip()
74 doc_id
= f
"{session_id}_{int(time.time())}"
75 # We store the session_id as metadata so NPCs only recall their OWN memories with this specific player
76 memory_collection
.add(
78 metadatas
=[{"session_id": session_id}
],
81 print(f
"[MEMORY DB] Memory Saved: {summary}")
83 except Exception as e
:
84 print(f
"[MEMORY ERROR] Failed to summarize memory: {e}")
86 memory_queue
.task_done()
87 # =====================================================================
90 async def process_message(r
, session
, message_data
):
92 data
= json
.loads(message_data
)
93 player_name
= data
.get('player', data
.get('target_player', 'Unknown'))
94 npc_tag
= data
.get('npc_tag', 'UnknownNPC')
95 message
= data
.get('message', '')
97 if not ALLOW_TEXT_EMOTES
:
98 message
= re
.sub(r
'\*.*?\*', '', message
).strip()
100 player_race
= data
.get('player_race', 'Unknown')
101 player_alignment
= data
.get('player_alignment', 'Unknown')
102 nearby_players
= data
.get('nearby_players', '')
104 npc_persona
= data
.get('persona', 'You are a generic citizen.')
105 npc_profession
= data
.get('profession', 'Commoner')
106 npc_mood
= data
.get('mood', 'Neutral')
107 npc_secret
= data
.get('secret', '')
109 npc_alignment
= data
.get('npc_alignment', 'True Neutral')
110 npc_gender
= data
.get('npc_gender', 'Unknown')
111 npc_race
= data
.get('npc_race', 'Creature')
112 npc_routine
= data
.get('npc_routine', '')
114 player_state
= data
.get('player_state', 'Relaxed and unarmed.')
115 world_state
= data
.get('world_state', 'Nothing of note is happening.')
116 npc_health
= data
.get('npc_health', 'Healthy and uninjured.')
117 relationship
= data
.get('relationship', 'Neutral or Friendly.')
118 location_context
= data
.get('location_context', 'You are in a generic area.')
120 group_context
= f
"Be aware that these other players are listening nearby: {nearby_players}." if nearby_players
else ""
121 secret_context
= f
"YOUR SECRET (Reveal only if players are persuasive): {npc_secret}" if npc_secret
else ""
122 routine_context
= f
"YOUR REQUIRED ROUTINE: {npc_routine}" if npc_routine
else ""
124 session_id
= f
"{player_name}_{npc_tag}"
126 # =====================================================================
127 # 2. THE DUAL RAG QUERY (Lore + Memories)
128 # =====================================================================
129 search_query
= f
"{location_context} {message}"
130 retrieved_lore
= "No specific local lore currently relevant."
134 if lore_collection
.count() > 0:
135 results
= lore_collection
.query(query_texts
=[search_query
], n_results
=1)
136 if results
['documents'] and results
['documents'][0]:
137 retrieved_lore
= f
"- {results['documents'][0][0]}"
139 # Fetch Episodic Memories (ONLY memories between this specific NPC and this specific Player)
140 if memory_collection
.count() > 0:
141 mem_results
= memory_collection
.query(
142 query_texts
=[search_query
],
144 where
={"session_id": session_id}
146 if mem_results
['documents'] and mem_results
['documents'][0]:
147 formatted_mems
= "\n- ".join(mem_results
['documents'][0])
148 past_memories
= f
"\nPAST MEMORIES OF {player_name}:\n- {formatted_mems}"
149 # =====================================================================
151 dynamic_system_prompt
= f
"""
155 CURRENT STATUS & TRAITS:
156 - Race & Gender: {npc_gender} {npc_race}
157 - Profession: {npc_profession}
158 - Alignment: {npc_alignment}
159 - Conversational Charisma: Low/Gruff unless otherwise specified.
160 - Current Mood: {npc_mood}
161 - Current Physical State: {npc_health}
165 CURRENT LOCATION: {location_context}
167 RELEVANT WORLD KNOWLEDGE:
171 CURRENT WORLD RUMORS/EVENTS:
174 CURRENT TARGET: You are speaking to {player_name}, who is a {player_alignment} {player_race}.
175 Their physical state: {player_state}
176 Relationship to you: {relationship}
178 React appropriately based on your personality, alignment, and mood.
180 CRITICAL ENGINE RULES:
181 Respond ONLY in valid JSON. You MUST use exactly these FIVE keys: "thought", "speech", "emotion", "action", and "action_target".
184 Your "action" key MUST be exactly one of the following words:
185 [WANDER, PATROL, FOLLOW, GUARD, GO_TO, INTERACT, USE_OBJECT, RETURN_TO_POST, ATTACK, REST, STEALTH, SEARCH, UNSTEALTH, PEACE, COMMAND]
188 Your "action" key MUST be exactly one of the following words:
189 [WANDER, PATROL, FOLLOW, GUARD, GO_TO, INTERACT, USE_OBJECT, RETURN_TO_POST, ATTACK, REST, STEALTH, SEARCH, UNSTEALTH, PEACE, COMMAND, CONVERSE]
191 - Use CONVERSE if you want to initiate a back-and-forth dialogue with a standard, unintelligent NPC. You will write their response for them.
193 YOUR RESPONSE MUST BE A SINGLE, VALID JSON OBJECT. YOU MUST USE THIS EXACT TEMPLATE:
195 "thought": "Your internal reasoning here.",
196 "speech": "What YOU say out loud.",
197 "emotion": "MACRO WORD",
198 "action": "MACRO WORD",
199 "action_target": "Target name",
200 "target_speech": "If action is CONVERSE, write what the target NPC replies back to you here. Otherwise, leave blank."
204 if session_id
not in chat_memory
:
205 chat_memory
[session_id
] = [{"role": "system", "content": dynamic_system_prompt}
]
207 chat_memory
[session_id
][0] = {"role": "system", "content": dynamic_system_prompt}
209 chat_memory
[session_id
].append({"role": "user", "content": f"{player_name} says
: {message}
"})
211 # =====================================================================
212 # --- THE MEMORY EXTRACTION TRIGGER ---
213 # =====================================================================
214 if len(chat_memory[session_id]) > 10:
215 # Grab the 5 oldest conversation messages (skipping the system prompt at [0])
216 messages_to_summarize = chat_memory[session_id][1:6]
217 chat_log_str = "\n".join([m['content'] for m in messages_to_summarize])
219 # Fire and forget: push it to the background queue!
220 await memory_queue.put({
221 'session_id': session_id,
222 'player_name': player_name,
224 'chat_log': chat_log_str
227 # Slide the window to keep live generation fast
228 chat_memory[session_id] = [chat_memory[session_id][0]] + chat_memory[session_id][-5:]
229 # =====================================================================
231 async with semaphore:
232 print(f"[THINKING
] Processing reply
for {player_name}
...")
233 async with session.post('http://localhost:11434/api/chat', json={
235 "messages
": chat_memory[session_id],
241 }, timeout=45) as response:
243 response.raise_for_status()
244 result = await response.json()
245 raw_reply_text = result['message']['content']
248 agent_brain = json.loads(raw_reply_text)
249 agent_brain = {k.lower(): v for k, v in agent_brain.items()}
251 if "thought
" not in agent_brain: agent_brain["thought
"] = ""
252 if "speech
" not in agent_brain: agent_brain["speech
"] = ""
253 if "emotion
" not in agent_brain: agent_brain["emotion
"] = "NEUTRAL
"
254 if "action
" not in agent_brain: agent_brain["action
"] = "GUARD
"
255 if "action_target
" not in agent_brain: agent_brain["action_target
"] = ""
256 if "target_speech
" not in agent_brain: agent_brain["target_speech
"] = ""
258 if not agent_brain["speech
"].strip():
259 agent_brain["speech
"] = "*grunts quietly
*"
261 agent_brain["action_target
"] = agent_brain["action_target
"].replace("?
", "").replace(".", "").strip()
263 clean_reply_text = json.dumps(agent_brain)
265 except json.JSONDecodeError:
266 print(f"[WARNING
] AI Hallucinated
! Overriding
with safe defaults
.")
267 clean_reply_text = json.dumps({
268 "thought
": "I lost my train of thought
.",
269 "speech
": "*grunts quietly
*",
270 "emotion
": "NEUTRAL
",
275 print(f"[REPLY
] from {npc_tag} to {player_name}
: {clean_reply_text}
")
276 chat_memory[session_id].append({"role": "assistant", "content": clean_reply_text})
280 "target_player
": player_name,
281 "reply
": clean_reply_text
283 await r.rpush('llm_to_nwn', json.dumps(reply_payload))
285 except Exception as e:
286 print(f"[ERROR
] Failed to process message
: {e}
")
289 print("Initializing Async Redis Bridge
...")
290 r = redis.Redis(host='127.0.0.1', port=6380, decode_responses=True)
294 print("SUCCESS
: Connected to the Docker Redis database
!")
295 except Exception as e:
296 print(f"CRITICAL ERROR
: Could
not connect to Redis
. {e}
")
299 print(f"Ready
! Listening
for game messages
. Max GPU concurrency
: {MAX_CONCURRENT_OLLAMA_REQUESTS}
")
301 async with aiohttp.ClientSession() as session:
302 # --- NEW: Start the background memory worker ---
303 asyncio.create_task(memory_summarizer_worker(session))
307 result = await r.blpop('nwn_to_llm')
309 queue_name, message_data = result
310 asyncio.create_task(process_message(r, session, message_data))
311 except Exception as e:
312 print(f"[LOOP ERROR
] {e}
")
313 await asyncio.sleep(1)
315 if __name__ == "__main__
":