@mythxengine/mcp-server 0.1.0

package/dist/tools/generation/monsters.js

@@ -0,0 +1,154 @@
+/**
+ * Monster Generation Tool
+ *
+ * Generates monsters based on the world seed.
+ */
+import { z } from "zod";
+import { randomUUID } from "crypto";
+import { sessionManager, readManifest, writeManifest, addManifestStep, } from "../../state/manager.js";
+import { buildRulesPromptSection, buildMonsterHPGuidelines } from "./rules-prompt.js";
+const GenerateMonstersInput = z.object({
+    sessionId: z.string(),
+    count: z.number().min(1).max(20).optional().describe("Number of monsters to generate"),
+    threatTiers: z.array(z.enum(["minion", "standard", "elite", "boss"])).optional().describe("Filter by threat tiers"),
+    focusOn: z.array(z.string()).optional().describe("Specific monster seeds to focus on (by name)"),
+});
+/**
+ * generate_monsters tool
+ */
+export const generateMonstersTool = {
+    name: "generate_monsters",
+    description: "Generate monsters based on the world seed. Returns a prompt for LLM execution.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            sessionId: { type: "string", description: "Session ID" },
+            count: { type: "number", description: "Number of monsters to generate" },
+            threatTiers: {
+                type: "array",
+                items: { type: "string", enum: ["minion", "standard", "elite", "boss"] },
+                description: "Filter by threat tiers"
+            },
+            focusOn: { type: "array", items: { type: "string" }, description: "Specific monster seeds to focus on" },
+        },
+        required: ["sessionId"],
+    },
+    handler: async (args) => {
+        const input = GenerateMonstersInput.parse(args);
+        const session = await sessionManager.get(input.sessionId);
+        if (!session) {
+            throw new Error(`Session not found: ${input.sessionId}`);
+        }
+        if (!session.generation?.worldSeed) {
+            throw new Error("World seed not found. Call generate_world_seed first.");
+        }
+        const worldSeed = session.generation.worldSeed;
+        const stepId = randomUUID();
+        // Filter monster seeds
+        let monsterSeeds = worldSeed.monsterSeeds;
+        if (input.focusOn) {
+            monsterSeeds = monsterSeeds.filter(m => input.focusOn.includes(m.name));
+        }
+        if (input.threatTiers) {
+            monsterSeeds = monsterSeeds.filter(m => input.threatTiers.includes(m.threat));
+        }
+        const count = input.count || monsterSeeds.length;
+        // Record the generation step
+        session.generation.history.push({
+            id: stepId,
+            type: "monsters",
+            startedAt: new Date().toISOString(),
+            completedAt: null,
+            status: "in_progress",
+            generatedIds: [],
+        });
+        session.generation.status = "generating";
+        await sessionManager.save(session);
+        // Update manifest
+        const manifest = await readManifest(input.sessionId);
+        if (manifest) {
+            addManifestStep(manifest, "monsters", "monsters.json");
+            manifest.status = "generating";
+            await writeManifest(input.sessionId, manifest);
+        }
+        // Build rules section from seed (uses defaults if no custom rules)
+        const rulesSection = buildRulesPromptSection(worldSeed.rules);
+        const monsterHPGuidelines = buildMonsterHPGuidelines(worldSeed.rules);
+        const systemPrompt = `You are a monster designer for tabletop RPGs. Create dangerous, memorable creatures that challenge players and fit the world's tone.
+
+${rulesSection}
+
+${monsterHPGuidelines}
+
+Design Guidelines:
+- Armor: 0-1 for most, 2-3 for heavily armored
+- Each monster needs 1-3 attacks with damage dice (d4, d6, d8, d10, d12)
+- Include morale, tactics, lore, and narrative text
+- Special abilities should be interesting but not overwhelming
+
+Output valid JSON only.`;
+        const userPrompt = `Generate ${count} monsters for this world:
+
+World: ${worldSeed.name}
+Tone: ${worldSeed.aesthetic.tone}
+Themes: ${worldSeed.aesthetic.themes.join(", ")}
+Visual Style: ${worldSeed.aesthetic.visualStyle}
+Core Conflict: ${worldSeed.coreConflict}
+Lethality: ${worldSeed.settings.lethality}
+Supernatural Presence: ${worldSeed.settings.supernaturalPresence}
+
+Monster seeds to develop:
+${monsterSeeds.slice(0, count).map((m, i) => `${i + 1}. ${m.name} (${m.threat}): ${m.concept}`).join("\n")}
+
+Output a JSON object:
+{
+  "monsters": [
+    {
+      "id": "monster:slug-name",
+      "name": "Monster Name",
+      "description": "Physical description",
+      "hp": 10,
+      "armor": 0,
+      "abilities": { "STR": 0, "AGI": 0, "WIT": -2, "CON": 0 },
+      "threat": "minion|standard|elite|boss",
+      "attacks": [
+        {
+          "name": "Attack Name",
+          "ability": "STR|AGI|WIT|CON",
+          "damage": "d6",
+          "properties": ["optional", "tags"],
+          "flavor": "Narrative description of the attack"
+        }
+      ],
+      "specialAbilities": ["Description of special ability"],
+      "morale": {
+        "threshold": 5,
+        "checkWhen": "belowHalfHP|allyDies|firstHit|never",
+        "fleesBelowHP": 3
+      },
+      "tactics": {
+        "preferredRange": "melee|ranged|any",
+        "targetPriority": "weakest|strongest|nearest|random",
+        "specialBehavior": "Optional tactical notes"
+      },
+      "lore": "World lore about this creature",
+      "encounterText": "Narrative text when first encountered",
+      "deathText": "Narrative text when defeated"
+    }
+  ]
+}
+
+Return ONLY the JSON object, no markdown formatting.`;
+        return {
+            prompt: {
+                system: systemPrompt,
+                user: userPrompt,
+                outputSchemaName: "WorldMonster[]",
+            },
+            stepId,
+            message: `Monster generation initiated for ${count} monsters. Execute the prompt and call save_generation_result.`,
+        };
+    },
+};
+export const monsterTools = [generateMonstersTool];
+//# sourceMappingURL=monsters.js.map

package/dist/tools/generation/monsters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"monsters.js","sourceRoot":"","sources":["../../../src/tools/generation/monsters.ts"],"names":[],"mappings":"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"}

package/dist/tools/generation/narrative.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Narrative Generation Tool
+ *
+ * Generates narrative guidance based on the world seed.
+ */
+import type { MCPToolEntry } from "@mythxengine/types";
+/**
+ * generate_narrative tool
+ */
+export declare const generateNarrativeTool: MCPToolEntry;
+export declare const narrativeTools: MCPToolEntry[];
+//# sourceMappingURL=narrative.d.ts.map

package/dist/tools/generation/narrative.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"narrative.d.ts","sourceRoot":"","sources":["../../../src/tools/generation/narrative.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAYvD;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,YAiInC,CAAC;AAEF,eAAO,MAAM,cAAc,gBAA0B,CAAC"}

package/dist/tools/generation/narrative.js

@@ -0,0 +1,129 @@
+/**
+ * Narrative Generation Tool
+ *
+ * Generates narrative guidance based on the world seed.
+ */
+import { z } from "zod";
+import { randomUUID } from "crypto";
+import { sessionManager, readManifest, writeManifest, addManifestStep, } from "../../state/manager.js";
+const GenerateNarrativeInput = z.object({
+    sessionId: z.string(),
+});
+/**
+ * generate_narrative tool
+ */
+export const generateNarrativeTool = {
+    name: "generate_narrative",
+    description: "Generate narrative guidance (opening scenes, plot hooks, conflicts) based on the world seed. Returns a prompt for LLM execution.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            sessionId: { type: "string", description: "Session ID" },
+        },
+        required: ["sessionId"],
+    },
+    handler: async (args) => {
+        const input = GenerateNarrativeInput.parse(args);
+        const session = await sessionManager.get(input.sessionId);
+        if (!session) {
+            throw new Error(`Session not found: ${input.sessionId}`);
+        }
+        if (!session.generation?.worldSeed) {
+            throw new Error("World seed not found. Call generate_world_seed first.");
+        }
+        const worldSeed = session.generation.worldSeed;
+        const stepId = randomUUID();
+        // Record the generation step
+        session.generation.history.push({
+            id: stepId,
+            type: "narrative",
+            startedAt: new Date().toISOString(),
+            completedAt: null,
+            status: "in_progress",
+            generatedIds: [],
+        });
+        session.generation.status = "generating";
+        await sessionManager.save(session);
+        // Update manifest
+        const manifest = await readManifest(input.sessionId);
+        if (manifest) {
+            addManifestStep(manifest, "narrative", "narrative.json");
+            manifest.status = "generating";
+            await writeManifest(input.sessionId, manifest);
+        }
+        const systemPrompt = `You are a narrative designer for tabletop RPGs. Create guidance that helps GMs and AI run compelling sessions in this world.
+
+Focus on:
+- Opening scenes that immediately establish tone and hook players
+- Plot hooks that connect to the core conflict
+- Common conflicts that arise naturally from the world
+- Resolution patterns that fit the world's tone
+
+Output valid JSON only.`;
+        const userPrompt = `Generate narrative guidance for this world:
+
+World: ${worldSeed.name}
+Tagline: ${worldSeed.tagline}
+Tone: ${worldSeed.aesthetic.tone}
+Themes: ${worldSeed.aesthetic.themes.join(", ")}
+Core Conflict: ${worldSeed.coreConflict}
+
+Archetypes:
+${worldSeed.archetypeSeeds.map(a => `- ${a.name}: ${a.concept}`).join("\n")}
+
+Key Locations:
+${worldSeed.locationSeeds.map(l => `- ${l.name}: ${l.concept}`).join("\n")}
+
+Important NPCs:
+${worldSeed.npcSeeds.map(n => `- ${n.name}: ${n.concept}`).join("\n")}
+
+Output a JSON object:
+{
+  "narrative": {
+    "openingScenes": [
+      "A vivid opening scene description that establishes tone",
+      "Another possible opening with different focus",
+      "A third option for variety"
+    ],
+    "plotHooks": [
+      "A hook that connects to the core conflict",
+      "A hook involving key NPCs",
+      "A hook tied to a specific location",
+      "A personal hook for player characters",
+      "A mysterious hook with unanswered questions"
+    ],
+    "commonConflicts": [
+      "A type of conflict that arises naturally",
+      "Another common source of tension",
+      "A recurring challenge players will face",
+      "An internal conflict characters might struggle with"
+    ],
+    "resolutionPatterns": [
+      "How victories typically look in this world",
+      "What partial successes might mean",
+      "How failures manifest and their consequences",
+      "Bittersweet outcomes that fit the tone"
+    ]
+  }
+}
+
+Notes:
+- Opening scenes should be read-aloud quality
+- Plot hooks should be immediately actionable
+- Conflicts should feel organic to the world
+- Resolution patterns should guide GM expectations
+
+Return ONLY the JSON object, no markdown formatting.`;
+        return {
+            prompt: {
+                system: systemPrompt,
+                user: userPrompt,
+                outputSchemaName: "NarrativeGuidance",
+            },
+            stepId,
+            message: `Narrative guidance generation initiated. Execute the prompt and call save_generation_result.`,
+        };
+    },
+};
+export const narrativeTools = [generateNarrativeTool];
+//# sourceMappingURL=narrative.js.map

package/dist/tools/generation/narrative.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"narrative.js","sourceRoot":"","sources":["../../../src/tools/generation/narrative.ts"],"names":[],"mappings":"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"}

package/dist/tools/generation/npcs.d.ts

@@ -0,0 +1,12 @@
+/**
+ * NPC Generation Tool
+ *
+ * Generates NPCs based on the world seed.
+ */
+import type { MCPToolEntry } from "@mythxengine/types";
+/**
+ * generate_npcs tool
+ */
+export declare const generateNPCsTool: MCPToolEntry;
+export declare const npcTools: MCPToolEntry[];
+//# sourceMappingURL=npcs.d.ts.map

package/dist/tools/generation/npcs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"npcs.d.ts","sourceRoot":"","sources":["../../../src/tools/generation/npcs.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAoB,MAAM,oBAAoB,CAAC;AAezE;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,YAsI9B,CAAC;AAEF,eAAO,MAAM,QAAQ,gBAAqB,CAAC"}

package/dist/tools/generation/npcs.js

@@ -0,0 +1,136 @@
+/**
+ * NPC Generation Tool
+ *
+ * Generates NPCs based on the world seed.
+ */
+import { z } from "zod";
+import { randomUUID } from "crypto";
+import { sessionManager, readManifest, writeManifest, addManifestStep, } from "../../state/manager.js";
+import { buildRulesPromptSection } from "./rules-prompt.js";
+const GenerateNPCsInput = z.object({
+    sessionId: z.string(),
+    count: z.number().min(1).max(20).optional().describe("Number of NPCs to generate (default: from world seed)"),
+    focusOn: z.array(z.string()).optional().describe("Specific NPC seeds to focus on (by name)"),
+});
+/**
+ * generate_npcs tool
+ */
+export const generateNPCsTool = {
+    name: "generate_npcs",
+    description: "Generate NPCs based on the world seed. Returns a prompt for LLM execution.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            sessionId: { type: "string", description: "Session ID" },
+            count: { type: "number", description: "Number of NPCs to generate" },
+            focusOn: { type: "array", items: { type: "string" }, description: "Specific NPC seeds to focus on" },
+        },
+        required: ["sessionId"],
+    },
+    handler: async (args) => {
+        const input = GenerateNPCsInput.parse(args);
+        const session = await sessionManager.get(input.sessionId);
+        if (!session) {
+            throw new Error(`Session not found: ${input.sessionId}`);
+        }
+        if (!session.generation?.worldSeed) {
+            throw new Error("World seed not found. Call generate_world_seed first.");
+        }
+        const worldSeed = session.generation.worldSeed;
+        const stepId = randomUUID();
+        const npcSeeds = input.focusOn
+            ? worldSeed.npcSeeds.filter(n => input.focusOn.includes(n.name))
+            : worldSeed.npcSeeds;
+        const count = input.count || npcSeeds.length;
+        // Record the generation step
+        session.generation.history.push({
+            id: stepId,
+            type: "npcs",
+            startedAt: new Date().toISOString(),
+            completedAt: null,
+            status: "in_progress",
+            generatedIds: [],
+        });
+        session.generation.status = "generating";
+        await sessionManager.save(session);
+        // Update manifest
+        const manifest = await readManifest(input.sessionId);
+        if (manifest) {
+            addManifestStep(manifest, "npcs", "npcs.json");
+            manifest.status = "generating";
+            await writeManifest(input.sessionId, manifest);
+        }
+        // Build rules section from seed (uses defaults if no custom rules)
+        const rulesSection = buildRulesPromptSection(worldSeed.rules);
+        const systemPrompt = `You are an NPC designer for tabletop RPGs. Create memorable characters with clear motivations that drive interesting interactions.
+
+${rulesSection}
+
+### NPC Design Guidelines
+- Each NPC needs a clear narrative role (quest_giver, ally, obstacle, information, antagonist, merchant, background)
+- Personality should be distinct and easy to roleplay
+- Motivation drives their actions and creates hooks
+- Dialogue hints help GMs voice the character
+- Include where they can be found (location IDs)
+- Relationships create webs of intrigue
+- Secrets add depth and discovery opportunities
+
+Output valid JSON only.`;
+        const userPrompt = `Generate ${count} NPCs for this world:
+
+World: ${worldSeed.name}
+Tone: ${worldSeed.aesthetic.tone}
+Themes: ${worldSeed.aesthetic.themes.join(", ")}
+Core Conflict: ${worldSeed.coreConflict}
+
+NPC seeds to develop:
+${npcSeeds.slice(0, count).map((n, i) => `${i + 1}. ${n.name}: ${n.concept}`).join("\n")}
+
+Locations where NPCs might be found:
+${worldSeed.locationSeeds.map(l => `- ${l.name}: ${l.concept}`).join("\n")}
+
+Output a JSON object:
+{
+  "npcs": [
+    {
+      "id": "npc:slug-name",
+      "name": "NPC Name",
+      "description": "Physical description and role",
+      "personality": "Key personality traits and quirks",
+      "motivation": "What drives this NPC's actions",
+      "attitude": "friendly|neutral|hostile|unknown",
+      "dialogueHints": [
+        "Example speech pattern or catchphrase",
+        "Topic they like to discuss",
+        "How they react to strangers"
+      ],
+      "narrativeRole": "quest_giver|ally|obstacle|information|antagonist|merchant|background",
+      "locations": ["location:where-they-can-be-found"],
+      "relationships": {
+        "npc:other-npc-id": "Description of relationship"
+      },
+      "secrets": ["Something hidden about this NPC"]
+    }
+  ]
+}
+
+Notes:
+- Mix narrative roles for variety
+- Create relationship connections between NPCs
+- Secrets are optional but add depth
+- Dialogue hints should make the NPC easy to voice
+
+Return ONLY the JSON object, no markdown formatting.`;
+        return {
+            prompt: {
+                system: systemPrompt,
+                user: userPrompt,
+                outputSchemaName: "WorldNPC[]",
+            },
+            stepId,
+            message: `NPC generation initiated for ${count} NPCs. Execute the prompt and call save_generation_result.`,
+        };
+    },
+};
+export const npcTools = [generateNPCsTool];
+//# sourceMappingURL=npcs.js.map

package/dist/tools/generation/npcs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"npcs.js","sourceRoot":"","sources":["../../../src/tools/generation/npcs.ts"],"names":[],"mappings":"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"}

package/dist/tools/generation/resume.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Resume Generation Tool
+ *
+ * Resumes an interrupted world generation session from file-based state.
+ */
+import type { MCPToolEntry } from "@mythxengine/types";
+/**
+ * resume_generation tool
+ */
+export declare const resumeGenerationTool: MCPToolEntry;
+export declare const resumeTools: MCPToolEntry[];
+//# sourceMappingURL=resume.d.ts.map

package/dist/tools/generation/resume.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resume.d.ts","sourceRoot":"","sources":["../../../src/tools/generation/resume.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAsB,MAAM,oBAAoB,CAAC;AAoO3E;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,YA0GlC,CAAC;AAEF,eAAO,MAAM,WAAW,gBAAyB,CAAC"}