run-dmcp 0.1.0

package/dist/register/mcp-prompts.js

@@ -0,0 +1,684 @@
+import { z } from "zod";
+import * as gameTools from "../tools/game.js";
+import * as characterTools from "../tools/character.js";
+import * as narrativeTools from "../tools/narrative.js";
+import * as pauseTools from "../tools/pause.js";
+import * as worldTools from "../tools/world.js";
+import * as questTools from "../tools/quest.js";
+import * as relationshipTools from "../tools/relationship.js";
+export function registerMcpPrompts(server) {
+    // ============================================================================
+    // DM PERSONA - Initialize the DM with full game context
+    // ============================================================================
+    server.registerPrompt("dm-persona", {
+        description: "Initialize DM persona with full game context and preferences",
+        argsSchema: {
+            gameId: z.string().describe("The game ID to load context from"),
+        },
+    }, async ({ gameId }) => {
+        const game = gameTools.loadGame(gameId);
+        if (!game) {
+            return {
+                messages: [
+                    {
+                        role: "user",
+                        content: {
+                            type: "text",
+                            text: `Error: Game ${gameId} not found.`,
+                        },
+                    },
+                ],
+            };
+        }
+        const state = gameTools.getGameState(gameId);
+        const preferences = game.preferences;
+        let promptText = `You are the Dungeon Master for "${game.name}", a ${game.style} ${game.setting} game.\n\n`;
+        if (preferences) {
+            promptText += `## Player Preferences\n`;
+            promptText += `- **Tone**: ${preferences.tone?.value || "Not specified"}\n`;
+            promptText += `- **Complexity**: ${preferences.complexity?.value || "Not specified"}\n`;
+            promptText += `- **Combat Frequency**: ${preferences.combatFrequency?.value || "Not specified"}\n`;
+            promptText += `- **Lethality**: ${preferences.lethality?.value || "Not specified"}\n`;
+            promptText += `- **Narrative Style**: ${preferences.narrativeStyle?.value || "Not specified"}\n`;
+            promptText += `- **Player Agency**: ${preferences.playerAgency?.value || "Not specified"}\n`;
+            promptText += `- **NPC Depth**: ${preferences.npcDepth?.value || "Not specified"}\n`;
+            promptText += `- **Romance Content**: ${preferences.romanceContent?.value || "Not specified"}\n`;
+            if (preferences.contentToAvoid?.length) {
+                promptText += `\n### Content to AVOID\n`;
+                preferences.contentToAvoid.forEach((item) => {
+                    promptText += `- ${item}\n`;
+                });
+            }
+            if (preferences.contentToInclude?.length) {
+                promptText += `\n### Content to INCLUDE\n`;
+                preferences.contentToInclude.forEach((item) => {
+                    promptText += `- ${item}\n`;
+                });
+            }
+            if (preferences.inspirations?.length) {
+                promptText += `\n### Inspirations\n`;
+                promptText += preferences.inspirations.join(", ") + "\n";
+            }
+        }
+        if (state) {
+            promptText += `\n## Current State\n`;
+            promptText += `- Characters: ${state.characterCount}\n`;
+            promptText += `- Locations: ${state.locationCount}\n`;
+            promptText += `- Active Quests: ${state.activeQuests}\n`;
+            promptText += `- Combat Active: ${state.activeCombat ? "Yes" : "No"}\n`;
+        }
+        promptText += `\n## DM Guidelines\n`;
+        promptText += `1. Stay consistent with the established tone and setting\n`;
+        promptText += `2. Honor player preferences and avoid restricted content\n`;
+        promptText += `3. Create immersive descriptions that match the genre\n`;
+        promptText += `\n## CRITICAL: State Persistence Rules\n`;
+        promptText += `The database IS the game state. Persist entities IMMEDIATELY as you introduce them in narrative:\n\n`;
+        promptText += `### Before Narrating, Persist:\n`;
+        promptText += `| Narrative Element | Tool to Call | When |\n`;
+        promptText += `|-------------------|--------------|------|\n`;
+        promptText += `| Named NPC | \`create_character\` | BEFORE their first dialogue/action |\n`;
+        promptText += `| New location | \`create_location\` + \`connect_locations\` | BEFORE describing what's there |\n`;
+        promptText += `| Item introduced | \`create_item\` | BEFORE player can interact with it |\n`;
+        promptText += `| Quest/mission given | \`create_quest\` | When objectives become clear |\n`;
+        promptText += `| NPC attitude established | \`create_relationship\` | When feelings toward player are shown |\n`;
+        promptText += `| Hidden information | \`create_secret\` | Even if revealed immediately |\n\n`;
+        promptText += `### After Every Narrative Beat:\n`;
+        promptText += `- Call \`log_event\` to record what happened (dialogue, action, discovery, combat, travel, decision)\n`;
+        promptText += `- Update relationships if interactions changed how NPCs feel\n`;
+        promptText += `- Transfer items if ownership changed\n`;
+        promptText += `- Mark quest objectives complete when achieved\n`;
+        promptText += `- Reveal secrets when characters learn information\n\n`;
+        promptText += `### Periodic Context Preservation:\n`;
+        promptText += `- Call \`check_context_freshness\` every 5-10 turns\n`;
+        promptText += `- Call \`save_context_snapshot\` after significant story beats\n`;
+        promptText += `- Never let more than 10-15 turns pass without a snapshot\n\n`;
+        promptText += `### Persistence Checklist (Mental Check After Each Response):\n`;
+        promptText += `- [ ] Did I mention anyone new? → create_character\n`;
+        promptText += `- [ ] Did I describe a new place? → create_location\n`;
+        promptText += `- [ ] Did items change hands? → create_item/transfer_item\n`;
+        promptText += `- [ ] Did relationships change? → create/update_relationship\n`;
+        promptText += `- [ ] Did anyone learn something? → create_secret/modify_secret_visibility\n`;
+        promptText += `- [ ] What happened? → log_event\n`;
+        return {
+            messages: [
+                {
+                    role: "user",
+                    content: { type: "text", text: promptText },
+                },
+            ],
+        };
+    });
+    // ============================================================================
+    // SESSION RECAP - Generate a narrative summary
+    // ============================================================================
+    server.registerPrompt("session-recap", {
+        description: "Generate a narrative recap of the game so far",
+        argsSchema: {
+            gameId: z.string().describe("The game ID"),
+        },
+    }, async ({ gameId }) => {
+        const game = gameTools.loadGame(gameId);
+        if (!game) {
+            return {
+                messages: [
+                    {
+                        role: "user",
+                        content: {
+                            type: "text",
+                            text: `Error: Game ${gameId} not found.`,
+                        },
+                    },
+                ],
+            };
+        }
+        const summary = narrativeTools.getSummary(gameId);
+        let promptText = `# Session Recap: ${game.name}\n\n`;
+        promptText += `**Setting**: ${game.setting}\n`;
+        promptText += `**Style**: ${game.style}\n\n`;
+        promptText += `## Statistics\n`;
+        promptText += `- Total Events: ${summary.totalEvents}\n`;
+        promptText += `- First Event: ${summary.firstEvent || "N/A"}\n`;
+        promptText += `- Last Event: ${summary.lastEvent || "N/A"}\n\n`;
+        if (Object.keys(summary.eventTypes).length > 0) {
+            promptText += `## Event Breakdown\n`;
+            for (const [type, count] of Object.entries(summary.eventTypes)) {
+                promptText += `- ${type}: ${count}\n`;
+            }
+            promptText += "\n";
+        }
+        if (summary.recentEvents.length > 0) {
+            promptText += `## Recent Events\n`;
+            for (const event of summary.recentEvents) {
+                promptText += `**[${event.eventType}]** ${event.content}\n\n`;
+            }
+        }
+        promptText += `---\n\nPlease provide a narrative summary of this session suitable for reminding the player where we left off.`;
+        return {
+            messages: [
+                {
+                    role: "user",
+                    content: { type: "text", text: promptText },
+                },
+            ],
+        };
+    });
+    // ============================================================================
+    // NEW GAME SETUP - Interview template for game creation
+    // ============================================================================
+    server.registerPrompt("new-game-setup", {
+        description: "Interview template for creating a new game",
+        argsSchema: {
+            genre: z.string().optional().describe("Optional: Pre-select a genre"),
+        },
+    }, async ({ genre }) => {
+        let promptText = `# New Game Setup Interview\n\n`;
+        promptText += `You are helping a player create their perfect tabletop RPG experience. Guide them through the following questions conversationally.\n\n`;
+        promptText += `## Instructions\n`;
+        promptText += `- Present questions in a friendly, conversational manner\n`;
+        promptText += `- Group related questions together\n`;
+        promptText += `- For each question, remind them they can:\n`;
+        promptText += `  - Choose from the options provided\n`;
+        promptText += `  - Give a custom answer\n`;
+        promptText += `  - Say "you decide" to delegate the choice to you\n\n`;
+        if (genre) {
+            promptText += `The player has indicated interest in: **${genre}**\n\n`;
+        }
+        promptText += `## Question Categories\n\n`;
+        promptText += `### 1. Core Identity\n`;
+        promptText += `- Genre (fantasy, sci-fi, horror, etc.)\n`;
+        promptText += `- Tone (grimdark, heroic, comedic, etc.)\n`;
+        promptText += `- Specific setting details\n\n`;
+        promptText += `### 2. Mechanics & Challenge\n`;
+        promptText += `- Rules complexity (light, medium, crunchy)\n`;
+        promptText += `- Combat frequency and style\n`;
+        promptText += `- Lethality level\n\n`;
+        promptText += `### 3. Narrative & Story\n`;
+        promptText += `- Narrative structure (linear, branching, sandbox)\n`;
+        promptText += `- Player agency level\n`;
+        promptText += `- NPC depth\n`;
+        promptText += `- Romance content handling\n\n`;
+        promptText += `### 4. World Building\n`;
+        promptText += `- World familiarity\n`;
+        promptText += `- Magic/tech prevalence\n`;
+        promptText += `- Political complexity\n\n`;
+        promptText += `### 5. Session & Pacing\n`;
+        promptText += `- Typical session length\n`;
+        promptText += `- Pacing preference\n\n`;
+        promptText += `### 6. Character\n`;
+        promptText += `- Character creation style\n`;
+        promptText += `- Starting power level\n\n`;
+        promptText += `### 7. Content & Safety\n`;
+        promptText += `- Topics to avoid\n`;
+        promptText += `- Topics to include\n`;
+        promptText += `- Media inspirations\n\n`;
+        promptText += `---\n\n`;
+        promptText += `After gathering preferences, use:\n`;
+        promptText += `1. \`create_game\` to create the game\n`;
+        promptText += `2. \`save_game_preferences\` to store their choices\n`;
+        promptText += `3. \`set_rules\` to establish the rule system\n`;
+        return {
+            messages: [
+                {
+                    role: "user",
+                    content: { type: "text", text: promptText },
+                },
+            ],
+        };
+    });
+    // ============================================================================
+    // CONTINUE GAME - Resume a paused session with full context
+    // ============================================================================
+    server.registerPrompt("continue-game", {
+        description: "Resume a paused game with full context restoration",
+        argsSchema: {
+            gameId: z.string().describe("The game ID to resume"),
+        },
+    }, async ({ gameId }) => {
+        const resumeContext = pauseTools.getResumeContext(gameId);
+        if (!resumeContext) {
+            // No pause state - try basic session load
+            const game = gameTools.loadGame(gameId);
+            if (!game) {
+                return {
+                    messages: [
+                        {
+                            role: "user",
+                            content: {
+                                type: "text",
+                                text: `Error: Game ${gameId} not found.`,
+                            },
+                        },
+                    ],
+                };
+            }
+            return {
+                messages: [
+                    {
+                        role: "user",
+                        content: {
+                            type: "text",
+                            text: `# Resuming: ${game.name}\n\nNo pause state was saved for this game. Use \`get_game_state\` and \`get_history\` to understand the current game state before continuing.`,
+                        },
+                    },
+                ],
+            };
+        }
+        let promptText = `# Resuming Game: ${resumeContext.gameState.game.name}\n\n`;
+        // Pause state context
+        const ps = resumeContext.pauseState;
+        promptText += `## Where We Left Off\n`;
+        promptText += `**Scene**: ${ps.currentScene}\n\n`;
+        promptText += `**Immediate Situation**: ${ps.immediateSituation}\n\n`;
+        if (ps.awaitingResponseTo) {
+            promptText += `**Awaiting Player Response To**: ${ps.awaitingResponseTo}\n\n`;
+        }
+        if (ps.pendingPlayerAction) {
+            promptText += `**Pending Player Action**: ${ps.pendingPlayerAction}\n\n`;
+        }
+        // DM Plans
+        if (ps.dmShortTermPlans || ps.dmLongTermPlans) {
+            promptText += `## DM Notes\n`;
+            if (ps.dmShortTermPlans) {
+                promptText += `**Short-term Plans**: ${ps.dmShortTermPlans}\n`;
+            }
+            if (ps.dmLongTermPlans) {
+                promptText += `**Long-term Plans**: ${ps.dmLongTermPlans}\n`;
+            }
+            promptText += "\n";
+        }
+        // Active threads
+        if (ps.activeThreads?.length) {
+            promptText += `## Active Story Threads\n`;
+            for (const thread of ps.activeThreads) {
+                promptText += `- **${thread.name}** (${thread.status}, ${thread.urgency} urgency): ${thread.description}\n`;
+            }
+            promptText += "\n";
+        }
+        // Player character
+        if (resumeContext.gameState.playerCharacter) {
+            const pc = resumeContext.gameState.playerCharacter;
+            promptText += `## Player Character\n`;
+            promptText += `**${pc.name}** - HP: ${pc.status?.health || "?"}/${pc.status?.maxHealth || "?"}\n`;
+            if (resumeContext.gameState.currentLocation) {
+                promptText += `**Location**: ${resumeContext.gameState.currentLocation.name}\n`;
+            }
+            promptText += "\n";
+        }
+        // Warnings
+        if (resumeContext.warnings?.length) {
+            promptText += `## Warnings\n`;
+            for (const warning of resumeContext.warnings) {
+                promptText += `- ${warning}\n`;
+            }
+            promptText += "\n";
+        }
+        // Recent events
+        if (resumeContext.gameState.recentEvents?.length) {
+            promptText += `## Recent Events\n`;
+            for (const event of resumeContext.gameState.recentEvents.slice(0, 5)) {
+                promptText += `- [${event.eventType}] ${event.content}\n`;
+            }
+            promptText += "\n";
+        }
+        promptText += `---\n\nResume the game from this point. The player is ready to continue.`;
+        return {
+            messages: [
+                {
+                    role: "user",
+                    content: { type: "text", text: promptText },
+                },
+            ],
+        };
+    });
+    // ============================================================================
+    // CHARACTER VOICE - NPC voice prompt for roleplay
+    // ============================================================================
+    server.registerPrompt("character-voice", {
+        description: "Get NPC voice characteristics for roleplay",
+        argsSchema: {
+            characterId: z.string().describe("The character ID"),
+        },
+    }, async ({ characterId }) => {
+        const character = characterTools.getCharacter(characterId);
+        if (!character) {
+            return {
+                messages: [
+                    {
+                        role: "user",
+                        content: {
+                            type: "text",
+                            text: `Error: Character ${characterId} not found.`,
+                        },
+                    },
+                ],
+            };
+        }
+        let promptText = `# Voice Profile: ${character.name}\n\n`;
+        if (character.voice) {
+            const v = character.voice;
+            promptText += `## Voice Characteristics\n`;
+            promptText += `- **Pitch**: ${v.pitch}\n`;
+            promptText += `- **Speed**: ${v.speed}\n`;
+            promptText += `- **Tone**: ${v.tone}\n`;
+            if (v.accent) {
+                promptText += `- **Accent**: ${v.accent}\n`;
+            }
+            if (v.quirks?.length) {
+                promptText += `\n## Speech Quirks\n`;
+                for (const quirk of v.quirks) {
+                    promptText += `- ${quirk}\n`;
+                }
+            }
+            if (v.description) {
+                promptText += `\n## Additional Notes\n${v.description}\n`;
+            }
+        }
+        else {
+            promptText += `No voice profile defined for this character.\n\n`;
+            promptText += `Consider these defaults based on the character:\n`;
+            promptText += `- Name: ${character.name}\n`;
+            promptText += `- Player Character: ${character.isPlayer ? "Yes" : "No"}\n`;
+            if (character.notes) {
+                promptText += `- Notes: ${character.notes}\n`;
+            }
+        }
+        promptText += `\n---\n\nWhen voicing ${character.name}, embody these characteristics in dialogue and narration.`;
+        return {
+            messages: [
+                {
+                    role: "user",
+                    content: { type: "text", text: promptText },
+                },
+            ],
+        };
+    });
+    // ============================================================================
+    // PERSISTENCE RULES - Standalone reminder of state persistence best practices
+    // ============================================================================
+    server.registerPrompt("persistence-rules", {
+        description: "Get a reminder of state persistence best practices - call this when you need guidance on what to persist and when",
+        argsSchema: {},
+    }, async () => {
+        let promptText = `# DMCP State Persistence Rules\n\n`;
+        promptText += `The database IS the game state. Everything mentioned in narrative should exist in the database.\n\n`;
+        promptText += `## The Golden Rule\n`;
+        promptText += `**Persist BEFORE you narrate.** Create entities in the database before describing them to the player.\n\n`;
+        promptText += `## Entity Persistence Guide\n\n`;
+        promptText += `### Characters (NPCs)\n`;
+        promptText += `**Trigger**: Any named character mentioned in dialogue or description\n`;
+        promptText += `**Tool**: \`create_character\` with \`isPlayer: false\`\n`;
+        promptText += `**When**: IMMEDIATELY when you decide to introduce them, BEFORE their first line of dialogue\n`;
+        promptText += `**Include**: name, initial location, basic attributes, notes about their role\n`;
+        promptText += `**Example flow**:\n`;
+        promptText += `1. Decide to introduce a blacksmith named Greta\n`;
+        promptText += `2. Call \`create_character\` for Greta\n`;
+        promptText += `3. THEN narrate: "A burly woman looks up from her anvil..."\n\n`;
+        promptText += `### Locations\n`;
+        promptText += `**Trigger**: Any place the player visits, hears about, or could travel to\n`;
+        promptText += `**Tools**: \`create_location\` then \`connect_locations\`\n`;
+        promptText += `**When**: BEFORE describing what the player sees there\n`;
+        promptText += `**Include**: name, atmospheric description, notable features\n`;
+        promptText += `**Example flow**:\n`;
+        promptText += `1. Player says "I go to the tavern"\n`;
+        promptText += `2. Call \`create_location\` for "The Rusty Nail Tavern"\n`;
+        promptText += `3. Call \`connect_locations\` to link it to current location\n`;
+        promptText += `4. THEN narrate the tavern scene\n\n`;
+        promptText += `### Items\n`;
+        promptText += `**Trigger**: Any item mentioned that could be picked up, used, or is plot-relevant\n`;
+        promptText += `**Tools**: \`create_item\`, \`transfer_item\`\n`;
+        promptText += `**When**: When the item first appears in narrative\n`;
+        promptText += `**Include**: name, description, owner (character or location), properties\n`;
+        promptText += `**Example flow**:\n`;
+        promptText += `1. Shopkeeper offers a magic sword for sale\n`;
+        promptText += `2. Call \`create_item\` with owner = shopkeeper's character ID\n`;
+        promptText += `3. If player buys it, call \`transfer_item\` to player\n\n`;
+        promptText += `### Relationships\n`;
+        promptText += `**Trigger**: NPC shows attitude toward player, alliances form, enmities established\n`;
+        promptText += `**Tools**: \`create_relationship\`, \`update_relationship_value\`\n`;
+        promptText += `**When**: When feelings/attitudes are expressed or implied\n`;
+        promptText += `**Include**: source, target, type (attitude, bond, rivalry), value (-100 to 100), label\n`;
+        promptText += `**Example flow**:\n`;
+        promptText += `1. NPC thanks player warmly for help\n`;
+        promptText += `2. Call \`create_relationship\` or \`update_relationship_value\` with positive delta\n`;
+        promptText += `3. Consider value ranges: -100 (hatred) to 0 (neutral) to +100 (devotion)\n\n`;
+        promptText += `### Quests\n`;
+        promptText += `**Trigger**: Player receives mission, discovers objective, or sets personal goal\n`;
+        promptText += `**Tools**: \`create_quest\`, \`modify_objectives\`\n`;
+        promptText += `**When**: When quest objectives become clear\n`;
+        promptText += `**Include**: name, description, clear trackable objectives\n`;
+        promptText += `**Example flow**:\n`;
+        promptText += `1. Village elder asks player to clear the mine\n`;
+        promptText += `2. Call \`create_quest\` with objectives like "Defeat the goblin chief", "Report back"\n`;
+        promptText += `3. When player defeats chief, call \`modify_objectives\` to mark complete\n\n`;
+        promptText += `### Secrets\n`;
+        promptText += `**Trigger**: Hidden information exists, even if revealed immediately\n`;
+        promptText += `**Tools**: \`create_secret\`, \`modify_secret_visibility\`, \`add_clue\`\n`;
+        promptText += `**When**: When you introduce information that could be discovered\n`;
+        promptText += `**Include**: name (DM reference), description (the actual secret), category, clues\n`;
+        promptText += `**Example flow**:\n`;
+        promptText += `1. You decide the innkeeper is secretly a spy\n`;
+        promptText += `2. Call \`create_secret\` with this information\n`;
+        promptText += `3. Add clues as you drop hints\n`;
+        promptText += `4. Call \`modify_secret_visibility\` when player discovers it\n\n`;
+        promptText += `### Narrative Events\n`;
+        promptText += `**Trigger**: EVERY significant narrative beat\n`;
+        promptText += `**Tool**: \`log_event\`\n`;
+        promptText += `**When**: After each narrative response, or during for long sequences\n`;
+        promptText += `**Event types**: dialogue, action, discovery, combat, travel, decision, scene_transition\n`;
+        promptText += `**Include**: eventType, content (what happened), optional metadata\n`;
+        promptText += `**Example**: After player negotiates with a merchant, log a "dialogue" event summarizing the exchange\n\n`;
+        promptText += `## Context Preservation\n\n`;
+        promptText += `### Regular Snapshots\n`;
+        promptText += `- Call \`check_context_freshness\` every 5-10 narrative turns\n`;
+        promptText += `- Call \`save_context_snapshot\` after significant story beats\n`;
+        promptText += `- Never let more than 10-15 turns pass without a snapshot\n\n`;
+        promptText += `### End of Session\n`;
+        promptText += `- Use the \`save-game-checklist\` prompt to verify all state is persisted\n`;
+        promptText += `- Call \`prepare_pause\` then \`save_pause_state\` with detailed context\n\n`;
+        promptText += `## Post-Response Checklist\n`;
+        promptText += `After EVERY narrative response, mentally verify:\n`;
+        promptText += `- [ ] Did I introduce anyone new? → \`create_character\`\n`;
+        promptText += `- [ ] Did I describe a new place? → \`create_location\` + \`connect_locations\`\n`;
+        promptText += `- [ ] Did items appear or change hands? → \`create_item\` / \`transfer_item\`\n`;
+        promptText += `- [ ] Did relationships change? → \`create_relationship\` / \`update_relationship_value\`\n`;
+        promptText += `- [ ] Did anyone learn something new? → \`create_secret\` / \`modify_secret_visibility\`\n`;
+        promptText += `- [ ] Did quest progress happen? → \`modify_objectives\`\n`;
+        promptText += `- [ ] What happened narratively? → \`log_event\`\n`;
+        return {
+            messages: [
+                {
+                    role: "user",
+                    content: { type: "text", text: promptText },
+                },
+            ],
+        };
+    });
+    // ============================================================================
+    // SAVE GAME CHECKLIST - Thorough pre-save verification
+    // ============================================================================
+    server.registerPrompt("save-game-checklist", {
+        description: "Comprehensive checklist for properly saving/pausing a game - ensures all entities are persisted",
+        argsSchema: {
+            gameId: z.string().describe("The game ID to save"),
+        },
+    }, async ({ gameId }) => {
+        const game = gameTools.loadGame(gameId);
+        if (!game) {
+            return {
+                messages: [
+                    {
+                        role: "user",
+                        content: {
+                            type: "text",
+                            text: `Error: Game ${gameId} not found.`,
+                        },
+                    },
+                ],
+            };
+        }
+        // Gather current state
+        const characters = characterTools.listCharacters(gameId);
+        const locations = worldTools.listLocations(gameId);
+        const quests = questTools.listQuests(gameId);
+        const relationships = relationshipTools.listRelationships(gameId);
+        const recentEvents = narrativeTools.getHistory(gameId, { limit: 20 });
+        // Build character and location name lists for reference
+        const _characterNames = characters.map(c => c.name.toLowerCase());
+        const _locationNames = locations.map(l => l.name.toLowerCase());
+        let promptText = `# Save Game Checklist: ${game.name}\n\n`;
+        promptText += `Before pausing the game, work through this checklist to ensure all game state is properly persisted.\n\n`;
+        // ========================================
+        // SECTION 1: Review Recent Narrative
+        // ========================================
+        promptText += `## 1. Review Recent Narrative\n\n`;
+        promptText += `Examine the recent narrative events below. For each event, verify that all mentioned entities exist in the database.\n\n`;
+        if (recentEvents.length > 0) {
+            promptText += `### Recent Events (${recentEvents.length})\n`;
+            promptText += `\`\`\`\n`;
+            for (const event of recentEvents.slice(0, 10)) {
+                promptText += `[${event.eventType}] ${event.content.slice(0, 200)}${event.content.length > 200 ? "..." : ""}\n\n`;
+            }
+            promptText += `\`\`\`\n\n`;
+        }
+        else {
+            promptText += `*No recent narrative events found.*\n\n`;
+        }
+        // ========================================
+        // SECTION 2: Character Verification
+        // ========================================
+        promptText += `## 2. Character Verification\n\n`;
+        promptText += `**Current Characters (${characters.length}):**\n`;
+        for (const char of characters) {
+            const status = char.isPlayer ? "PC" : "NPC";
+            promptText += `- ${char.name} (${status}) - HP: ${char.status.health}/${char.status.maxHealth}`;
+            if (char.status.conditions.length > 0) {
+                promptText += ` - Conditions: ${char.status.conditions.join(", ")}`;
+            }
+            promptText += `\n`;
+        }
+        promptText += `\n`;
+        promptText += `### Verify:\n`;
+        promptText += `- [ ] All NPCs mentioned in recent dialogue/narrative are created\n`;
+        promptText += `- [ ] Character health reflects any damage/healing from recent events\n`;
+        promptText += `- [ ] Status conditions (poisoned, stunned, etc.) are applied/removed\n`;
+        promptText += `- [ ] Character locations are up to date\n`;
+        promptText += `- [ ] XP/level changes are recorded\n`;
+        promptText += `- [ ] Any new skills or abilities are added\n\n`;
+        // ========================================
+        // SECTION 3: Location Verification
+        // ========================================
+        promptText += `## 3. Location Verification\n\n`;
+        promptText += `**Current Locations (${locations.length}):**\n`;
+        for (const loc of locations) {
+            const exits = loc.properties.exits?.length || 0;
+            promptText += `- ${loc.name} (${exits} exits)\n`;
+        }
+        promptText += `\n`;
+        promptText += `### Verify:\n`;
+        promptText += `- [ ] All visited locations are created with descriptions\n`;
+        promptText += `- [ ] Location connections (exits) are properly set up\n`;
+        promptText += `- [ ] Items left at locations are recorded\n`;
+        promptText += `- [ ] Location atmosphere/state changes are updated\n\n`;
+        // ========================================
+        // SECTION 4: Quest & Objective Tracking
+        // ========================================
+        promptText += `## 4. Quest & Objective Tracking\n\n`;
+        const activeQuests = quests.filter(q => q.status === "active");
+        const _completedQuests = quests.filter(q => q.status === "completed");
+        promptText += `**Active Quests (${activeQuests.length}):**\n`;
+        for (const quest of activeQuests) {
+            const completed = quest.objectives.filter(o => o.completed).length;
+            const total = quest.objectives.length;
+            promptText += `- ${quest.name} (${completed}/${total} objectives)\n`;
+            for (const obj of quest.objectives) {
+                promptText += `  ${obj.completed ? "✅" : "⬜"} ${obj.description}\n`;
+            }
+        }
+        promptText += `\n`;
+        promptText += `### Verify:\n`;
+        promptText += `- [ ] Any new quests/missions mentioned are created\n`;
+        promptText += `- [ ] Completed objectives are marked as complete\n`;
+        promptText += `- [ ] Failed quests are marked as failed\n`;
+        promptText += `- [ ] New objectives discovered are added\n`;
+        promptText += `- [ ] Quest rewards given are recorded\n\n`;
+        // ========================================
+        // SECTION 5: Relationships
+        // ========================================
+        promptText += `## 5. Relationship Updates\n\n`;
+        promptText += `**Current Relationships (${relationships.length}):**\n`;
+        for (const rel of relationships.slice(0, 10)) {
+            promptText += `- ${rel.sourceId} → ${rel.targetId}: ${rel.relationshipType} (${rel.value}, ${rel.label || "no label"})\n`;
+        }
+        if (relationships.length > 10) {
+            promptText += `  ... and ${relationships.length - 10} more\n`;
+        }
+        promptText += `\n`;
+        promptText += `### Verify:\n`;
+        promptText += `- [ ] NPC attitudes changed by recent interactions are updated\n`;
+        promptText += `- [ ] New alliances or enmities are recorded\n`;
+        promptText += `- [ ] Faction relationships affected by player actions are updated\n`;
+        promptText += `- [ ] Romantic/friendship developments are tracked\n\n`;
+        // ========================================
+        // SECTION 6: Items & Inventory
+        // ========================================
+        promptText += `## 6. Items & Inventory\n\n`;
+        promptText += `### Verify:\n`;
+        promptText += `- [ ] Items given to players are added to their inventory\n`;
+        promptText += `- [ ] Items used/consumed are removed or updated\n`;
+        promptText += `- [ ] Loot from combat is distributed\n`;
+        promptText += `- [ ] Gold/currency changes are recorded\n`;
+        promptText += `- [ ] Items dropped at locations are transferred\n\n`;
+        // ========================================
+        // SECTION 7: World State & Time
+        // ========================================
+        promptText += `## 7. World State & Time\n\n`;
+        promptText += `### Verify:\n`;
+        promptText += `- [ ] In-game time has been advanced appropriately\n`;
+        promptText += `- [ ] Scheduled events are set for future triggers\n`;
+        promptText += `- [ ] Timers/countdowns are updated\n`;
+        promptText += `- [ ] World changes from player actions are reflected\n\n`;
+        // ========================================
+        // SECTION 8: Secrets & Knowledge
+        // ========================================
+        promptText += `## 8. Secrets & Knowledge\n\n`;
+        promptText += `### Verify:\n`;
+        promptText += `- [ ] Secrets discovered by players are revealed to them\n`;
+        promptText += `- [ ] Clues found are added to relevant secrets\n`;
+        promptText += `- [ ] New secrets introduced are created\n`;
+        promptText += `- [ ] Character knowledge is updated\n\n`;
+        // ========================================
+        // SECTION 9: Save Pause State
+        // ========================================
+        promptText += `## 9. Save DM Context\n\n`;
+        promptText += `After verifying the above, use \`save_pause_state\` to capture:\n\n`;
+        promptText += `### Required:\n`;
+        promptText += `- **currentScene**: Where are we in the story?\n`;
+        promptText += `- **immediateSituation**: What is happening RIGHT NOW?\n\n`;
+        promptText += `### Recommended:\n`;
+        promptText += `- **dmShortTermPlans**: What was about to happen next?\n`;
+        promptText += `- **dmLongTermPlans**: Major arcs being developed\n`;
+        promptText += `- **activeThreads**: Ongoing storylines and their status\n`;
+        promptText += `- **npcAttitudes**: Current NPC emotional states\n`;
+        promptText += `- **pendingPlayerAction**: What was the player considering?\n`;
+        promptText += `- **upcomingReveals**: Secrets close to being discovered\n`;
+        promptText += `- **sceneAtmosphere**: Mood, lighting, tension\n\n`;
+        // ========================================
+        // SECTION 10: Final Actions
+        // ========================================
+        promptText += `## 10. Final Actions\n\n`;
+        promptText += `1. **Log a summary event**: Use \`log_event\` with type "session_end" to record a brief summary\n`;
+        promptText += `2. **Generate recap note**: Use \`generate_recap\` to create a recap note\n`;
+        promptText += `3. **Save pause state**: Use \`save_pause_state\` with all relevant context\n`;
+        promptText += `4. **Confirm to player**: Let them know the game is saved and summarize where they left off\n\n`;
+        promptText += `---\n\n`;
+        promptText += `Work through each section, making tool calls to create/update any missing entities, then save the pause state.`;
+        return {
+            messages: [
+                {
+                    role: "user",
+                    content: { type: "text", text: promptText },
+                },
+            ],
+        };
+    });
+}