@mythxengine/mcp-server 0.1.0

package/dist/tools/generation/seed.js

@@ -0,0 +1,171 @@
+/**
+ * World Seed Generation Tool
+ *
+ * Creates the foundation for a new world from a campaign seed prompt.
+ */
+import { z } from "zod";
+import { randomUUID } from "crypto";
+import { createEmptyGenerationSession } from "@mythxengine/types";
+import { sessionManager, ensureGenerationDir, writeManifest, createManifest, addManifestStep, } from "../../state/manager.js";
+import { buildRulesPromptSection } from "./rules-prompt.js";
+const GenerateWorldSeedInput = z.object({
+    sessionId: z.string(),
+    campaignSeed: z.string().describe("The creative prompt for world generation (e.g., 'noir detective in a steampunk city')"),
+    tier: z.enum(["small", "medium", "large"]).optional().default("medium").describe("World size: small (3 archetypes, 4 locations), medium (4 archetypes, 6 locations), large (6 archetypes, 10 locations)"),
+    settings: z.object({
+        lethality: z.enum(["low", "medium", "high", "brutal"]).optional(),
+        magicLevel: z.enum(["none", "rare", "common", "high"]).optional(),
+        technologyLevel: z.enum(["primitive", "medieval", "renaissance", "industrial", "modern", "futuristic"]).optional(),
+        supernaturalPresence: z.enum(["subtle", "common", "pervasive"]).optional(),
+    }).optional(),
+    /** Optional rules configuration for genre-specific mechanics */
+    rulesConfig: z.any().optional().describe("Optional rules configuration for custom abilities, mechanics, or tests"),
+});
+/**
+ * generate_world_seed tool
+ */
+export const generateWorldSeedTool = {
+    name: "generate_world_seed",
+    description: "Create the foundation for a new world from a campaign seed prompt. Returns a prompt for LLM execution.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            sessionId: { type: "string", description: "Session ID" },
+            campaignSeed: { type: "string", description: "Creative prompt for world generation (e.g., 'noir detective in a steampunk city')" },
+            tier: {
+                type: "string",
+                enum: ["small", "medium", "large"],
+                description: "World size: small (3 archetypes, 4 locations), medium (4 archetypes, 6 locations), large (6 archetypes, 10 locations)"
+            },
+            settings: {
+                type: "object",
+                properties: {
+                    lethality: { type: "string", enum: ["low", "medium", "high", "brutal"] },
+                    magicLevel: { type: "string", enum: ["none", "rare", "common", "high"] },
+                    technologyLevel: { type: "string", enum: ["primitive", "medieval", "renaissance", "industrial", "modern", "futuristic"] },
+                    supernaturalPresence: { type: "string", enum: ["subtle", "common", "pervasive"] },
+                },
+                description: "Optional world settings overrides"
+            },
+            rulesConfig: {
+                type: "object",
+                description: "Optional rules configuration for custom abilities, mechanics, or tests (e.g., Mothership-style panic checks)",
+            },
+        },
+        required: ["sessionId", "campaignSeed"],
+    },
+    handler: async (args) => {
+        const input = GenerateWorldSeedInput.parse(args);
+        const session = await sessionManager.get(input.sessionId);
+        if (!session) {
+            throw new Error(`Session not found: ${input.sessionId}`);
+        }
+        // Initialize generation session if not present
+        if (!session.generation) {
+            session.generation = createEmptyGenerationSession();
+        }
+        // Check if already seeded
+        if (session.generation.worldSeed) {
+            throw new Error("World already seeded. Create a new session to generate a different world.");
+        }
+        const stepId = randomUUID();
+        const tier = input.tier || "medium";
+        const tierCounts = {
+            small: { archetypes: 3, locations: 4, npcs: 3, monsters: 6 },
+            medium: { archetypes: 4, locations: 6, npcs: 5, monsters: 10 },
+            large: { archetypes: 6, locations: 10, npcs: 8, monsters: 15 },
+        };
+        const counts = tierCounts[tier];
+        // Record the generation step
+        session.generation.history.push({
+            id: stepId,
+            type: "seed",
+            startedAt: new Date().toISOString(),
+            completedAt: null,
+            status: "in_progress",
+            generatedIds: [],
+        });
+        session.generation.status = "seeding";
+        await sessionManager.save(session);
+        // Create generation directory and initial manifest
+        await ensureGenerationDir(input.sessionId);
+        const manifest = createManifest(input.sessionId, input.campaignSeed, tier, input.settings, input.rulesConfig);
+        addManifestStep(manifest, "seed", "seed.json");
+        await writeManifest(input.sessionId, manifest);
+        // Build the rules section for the prompt
+        const rulesSection = buildRulesPromptSection(input.rulesConfig);
+        // Build the system prompt
+        const systemPrompt = `You are a world-building expert for tabletop RPGs. You create compelling, internally consistent worlds that are immediately playable.
+
+Your output must be valid JSON matching the WorldSeed schema. Focus on:
+- Creating a unique, evocative world concept
+- Establishing clear aesthetic and tonal guidelines
+- Seeding interesting archetypes, locations, NPCs, and monsters
+- Ensuring the core conflict drives gameplay
+
+${rulesSection}`;
+        // Build the user prompt
+        const settingsOverrides = input.settings ? `
+
+The user has specified these settings:
+${input.settings.lethality ? `- Lethality: ${input.settings.lethality}` : ""}
+${input.settings.magicLevel ? `- Magic Level: ${input.settings.magicLevel}` : ""}
+${input.settings.technologyLevel ? `- Technology Level: ${input.settings.technologyLevel}` : ""}
+${input.settings.supernaturalPresence ? `- Supernatural Presence: ${input.settings.supernaturalPresence}` : ""}
+` : "";
+        // Rules config JSON for inclusion in output (if provided)
+        const rulesConfigJson = input.rulesConfig
+            ? `\n  "rules": ${JSON.stringify(input.rulesConfig)},`
+            : "";
+        const userPrompt = `Create a world seed for this campaign concept:
+
+<campaign_seed>
+${input.campaignSeed}
+</campaign_seed>
+
+World size tier: ${input.tier || "medium"}
+- ${counts.archetypes} archetype seeds (name + brief concept)
+- ${counts.locations} location seeds (name + brief concept)
+- ${counts.npcs} NPC seeds (name + brief concept)
+- ${counts.monsters} monster seeds (name + concept + threat tier)
+${settingsOverrides}
+Output a JSON object with this structure:
+{
+  "id": "world-id-slug",
+  "name": "World Name",
+  "tagline": "One-line hook",
+  "campaignSeed": "${input.campaignSeed}",
+  "aesthetic": {
+    "visualStyle": "Visual description",
+    "tone": "Emotional tone",
+    "themes": ["theme1", "theme2"],
+    "inspirations": ["inspiration1", "inspiration2"]
+  },
+  "settings": {
+    "lethality": "low|medium|high|brutal",
+    "magicLevel": "none|rare|common|high",
+    "technologyLevel": "primitive|medieval|renaissance|industrial|modern|futuristic",
+    "supernaturalPresence": "subtle|common|pervasive"
+  },${rulesConfigJson}
+  "coreConflict": "Description of the central conflict",
+  "archetypeSeeds": [{"name": "Name", "concept": "Brief concept"}],
+  "locationSeeds": [{"name": "Name", "concept": "Brief concept"}],
+  "npcSeeds": [{"name": "Name", "concept": "Brief concept"}],
+  "monsterSeeds": [{"name": "Name", "concept": "Brief concept", "threat": "minion|standard|elite|boss"}],
+  "createdAt": "${new Date().toISOString()}"
+}
+
+Return ONLY the JSON object, no markdown formatting or explanation.`;
+        return {
+            prompt: {
+                system: systemPrompt,
+                user: userPrompt,
+                outputSchemaName: "WorldSeed",
+            },
+            stepId,
+            message: `World seed generation initiated for: "${input.campaignSeed}". Execute the prompt with an LLM and call save_generation_result with the output.`,
+        };
+    },
+};
+export const seedTools = [generateWorldSeedTool];
+//# sourceMappingURL=seed.js.map

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

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

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

@@ -0,0 +1,13 @@
+/**
+ * Situation Generation Tool
+ *
+ * Generates situations (nodes) for Alexandrian-style node-based scenario design.
+ * Each situation represents a set of circumstances that will change without PC intervention.
+ */
+import type { MCPToolEntry } from "@mythxengine/types";
+/**
+ * generate_situations tool
+ */
+export declare const generateSituationsTool: MCPToolEntry;
+export declare const situationTools: MCPToolEntry[];
+//# sourceMappingURL=situations.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"situations.d.ts","sourceRoot":"","sources":["../../../src/tools/generation/situations.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAcvD;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,YAuPpC,CAAC;AAEF,eAAO,MAAM,cAAc,gBAA2B,CAAC"}

package/dist/tools/generation/situations.js

@@ -0,0 +1,247 @@
+/**
+ * Situation Generation Tool
+ *
+ * Generates situations (nodes) for Alexandrian-style node-based scenario design.
+ * Each situation represents a set of circumstances that will change without PC intervention.
+ */
+import { z } from "zod";
+import { randomUUID } from "crypto";
+import { sessionManager, readManifest, writeManifest, addManifestStep, } from "../../state/manager.js";
+const GenerateSituationsInput = z.object({
+    sessionId: z.string(),
+    count: z.number().min(1).max(20).optional().describe("Number of situations to generate (default: from world seed or 5)"),
+    focusOn: z.array(z.string()).optional().describe("Specific situation seeds to focus on (by name)"),
+});
+/**
+ * generate_situations tool
+ */
+export const generateSituationsTool = {
+    name: "generate_situations",
+    description: "Generate situations (nodes) based on the world seed using Alexandrian node-based design. Returns a prompt for LLM execution.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            sessionId: { type: "string", description: "Session ID" },
+            count: { type: "number", description: "Number of situations to generate" },
+            focusOn: { type: "array", items: { type: "string" }, description: "Specific situation seeds to focus on" },
+        },
+        required: ["sessionId"],
+    },
+    handler: async (args) => {
+        const input = GenerateSituationsInput.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;
+        // Get existing content for references
+        const existingNpcs = session.generation.generatedContent.npcs;
+        const existingLocations = session.generation.generatedContent.locations;
+        const stepId = randomUUID();
+        const situationSeeds = input.focusOn && worldSeed.situationSeeds
+            ? worldSeed.situationSeeds.filter(s => input.focusOn.includes(s.name))
+            : worldSeed.situationSeeds || [];
+        const count = input.count || situationSeeds.length || 5;
+        // Record the generation step
+        session.generation.history.push({
+            id: stepId,
+            type: "situations",
+            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, "situations", "situations.json");
+            manifest.status = "generating";
+            await writeManifest(input.sessionId, manifest);
+        }
+        const systemPrompt = `You are a scenario designer for tabletop RPGs, expert in The Alexandrian's node-based scenario design.
+
+You create SITUATIONS - dynamic circumstances that will change without PC intervention. Each situation is a node in a navigable network connected by LEADS (clues that point to other situations).
+
+Key Principles:
+1. THREE CLUE RULE: Each important situation should have at least 3 ways to discover it
+2. PROACTIVE ELEMENTS: Include clocks showing what happens if PCs don't act
+3. LEADS AS EDGES: Connect situations with discoverable information
+4. SITUATIONS NOT PLOTS: Describe circumstances, not predetermined events
+
+Output valid JSON only.`;
+        const npcList = existingNpcs.length > 0
+            ? `\nExisting NPCs (use these IDs):\n${existingNpcs.map(n => `- ${n.id}: ${n.name}`).join("\n")}`
+            : `\nNPC seeds (create IDs like "npc:slug-name"):\n${worldSeed.npcSeeds.map(n => `- ${n.name}: ${n.concept}`).join("\n")}`;
+        const locationList = existingLocations.length > 0
+            ? `\nExisting Locations (use these IDs):\n${existingLocations.map(l => `- ${l.id}: ${l.name}`).join("\n")}`
+            : `\nLocation seeds (create IDs like "location:slug-name"):\n${worldSeed.locationSeeds.map(l => `- ${l.name}: ${l.concept}`).join("\n")}`;
+        const userPrompt = `Generate ${count} interconnected situations for this world:
+
+World: ${worldSeed.name}
+Tone: ${worldSeed.aesthetic.tone}
+Themes: ${worldSeed.aesthetic.themes.join(", ")}
+Core Conflict: ${worldSeed.coreConflict}
+
+${situationSeeds.length > 0 ? `Situation seeds to develop:\n${situationSeeds.slice(0, count).map((s, i) => `${i + 1}. ${s.name}: ${s.concept}${s.urgency ? ` (urgency: ${s.urgency})` : ""}`).join("\n")}` : "Create situations that explore the core conflict from different angles."}
+${npcList}
+${locationList}
+
+Output a JSON object:
+{
+  "situations": [
+    {
+      "id": "situation:slug-name",
+      "name": "Situation Name",
+      "description": "What's happening and why it matters",
+      "status": "brewing",
+
+      "stakes": {
+        "risks": ["What could go wrong"],
+        "opportunities": ["What could be gained"],
+        "primaryVictim": "Who suffers if ignored (optional)",
+        "ifIgnored": "What happens without PC intervention"
+      },
+
+      "actors": [
+        {
+          "entityId": "npc:entity-id or faction:id",
+          "agenda": "What they want",
+          "leverage": "Their power/resources",
+          "defaultAction": "What they do if unopposed",
+          "isPrimaryAntagonist": true
+        }
+      ],
+
+      "locations": {
+        "primary": ["location:main-location"],
+        "related": ["location:secondary"],
+        "details": {
+          "location:main-location": "Location-specific context"
+        }
+      },
+
+      "clock": {
+        "id": "clock:situation-name",
+        "name": "Clock Name",
+        "doom": "What the clock counts toward",
+        "stages": [
+          {
+            "id": "stage-1",
+            "name": "Stage Name",
+            "description": "What happens",
+            "trigger": {
+              "type": "time",
+              "minutesFromStart": 1440
+            },
+            "consequences": {
+              "setFlags": ["flag-name"],
+              "narrative": "Description of what changes"
+            },
+            "reversible": true
+          }
+        ],
+        "currentStage": null,
+        "startedAt": null,
+        "paused": false
+      },
+
+      "outgoingLeads": [
+        {
+          "id": "lead:source-to-target-method",
+          "information": "What the lead reveals",
+          "targetSituationId": "situation:target-id",
+          "discovery": {
+            "method": "npc|location|investigation|observation|document|consequence|rumor|item",
+            "sourceId": "npc:or-location:id",
+            "description": "How to find this lead"
+          },
+          "prominence": "obvious|available|hidden|obscured"
+        }
+      ],
+
+      "entryPoints": {
+        "incomingLeadIds": [],
+        "directDiscovery": [
+          {
+            "method": "Observation",
+            "description": "How PCs can stumble upon this",
+            "locationId": "location:where"
+          }
+        ],
+        "minimumLeadsTarget": 3
+      },
+
+      "complications": [
+        {
+          "id": "comp-1",
+          "description": "What makes this hard",
+          "type": "obstacle|opposition|moral|resource|time|information|relationship",
+          "resolutions": ["Possible way to resolve"]
+        }
+      ],
+
+      "outcomes": {
+        "victory": {
+          "description": "Full success",
+          "consequences": ["What changes"],
+          "flagsSet": ["victory-flag"]
+        },
+        "failure": {
+          "description": "Complete failure",
+          "consequences": ["What goes wrong"],
+          "flagsSet": ["failure-flag"]
+        },
+        "partial": [
+          {
+            "name": "Partial Success",
+            "description": "Mixed outcome",
+            "consequences": ["Some good, some bad"],
+            "flagsSet": ["partial-flag"]
+          }
+        ]
+      },
+
+      "gmGuidance": {
+        "themes": ["Thematic elements"],
+        "toneNotes": "How to run this",
+        "anticipatedApproaches": [
+          {
+            "approach": "Players might try...",
+            "response": "NPCs/world responds by..."
+          }
+        ],
+        "foreshadowing": ["Hints to drop earlier"]
+      },
+
+      "tags": ["tag1", "tag2"],
+      "layer": 1
+    }
+  ]
+}
+
+IMPORTANT:
+- Create leads that connect situations to each other
+- Ensure each situation has at least 3 entry points (leads + direct discovery)
+- Include clocks for time-sensitive situations
+- Vary discovery methods and prominence levels
+- Connect actors to NPCs and locations
+
+Return ONLY the JSON object, no markdown formatting.`;
+        return {
+            prompt: {
+                system: systemPrompt,
+                user: userPrompt,
+                outputSchemaName: "WorldSituation[]",
+            },
+            stepId,
+            message: `Situation generation initiated for ${count} situations. Execute the prompt and call save_generation_result.`,
+        };
+    },
+};
+export const situationTools = [generateSituationsTool];
+//# sourceMappingURL=situations.js.map

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

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

package/dist/tools/gm-guidance.d.ts

@@ -0,0 +1,13 @@
+/**
+ * GM Context & Guidance Tool
+ *
+ * Provides context-aware GM advice during gameplay.
+ * Makes the wisdom from GM prompts operationally accessible.
+ */
+import type { MCPToolEntry } from "@mythxengine/types";
+/**
+ * get_gm_guidance tool
+ */
+export declare const getGmGuidanceTool: MCPToolEntry;
+export declare const gmGuidanceTools: MCPToolEntry[];
+//# sourceMappingURL=gm-guidance.d.ts.map

package/dist/tools/gm-guidance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gm-guidance.d.ts","sourceRoot":"","sources":["../../src/tools/gm-guidance.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAY,MAAM,oBAAoB,CAAC;AAycjE;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,YAoE/B,CAAC;AAEF,eAAO,MAAM,eAAe,gBAAsB,CAAC"}