@mythxengine/mcp-server 0.1.0

package/dist/tools/expansion/npc.js

@@ -0,0 +1,153 @@
+/**
+ * NPC Expansion Tool
+ *
+ * Expands an NPC with additional detail.
+ */
+import { z } from "zod";
+import { randomUUID } from "crypto";
+import { sessionManager, readManifest, writeManifest, addManifestStep, } from "../../state/manager.js";
+const ExpandNPCInput = z.object({
+    sessionId: z.string(),
+    npcId: z.string().describe("ID of the NPC to expand"),
+});
+/**
+ * expand_npc tool
+ */
+export const expandNPCTool = {
+    name: "expand_npc",
+    description: "Expand an NPC with additional detail (backstory, combat stats, quest hooks). Returns a prompt for LLM execution.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            sessionId: { type: "string", description: "Session ID" },
+            npcId: { type: "string", description: "ID of the NPC to expand" },
+        },
+        required: ["sessionId", "npcId"],
+    },
+    handler: async (args) => {
+        const input = ExpandNPCInput.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;
+        // Find the NPC
+        const npcs = session.generation.generatedContent.npcs;
+        const npc = npcs.find((n) => n.id === input.npcId);
+        if (!npc) {
+            throw new Error(`NPC not found: ${input.npcId}`);
+        }
+        // Check if already expanded
+        const expandedNPCs = session.generation.expansions.npcs;
+        const alreadyExpanded = expandedNPCs.find((n) => n.id === input.npcId);
+        if (alreadyExpanded) {
+            throw new Error(`NPC already expanded: ${input.npcId}`);
+        }
+        const stepId = randomUUID();
+        // Get items for inventory
+        const items = session.generation.generatedContent.items;
+        // Record the generation step
+        session.generation.history.push({
+            id: stepId,
+            type: "expand_npc",
+            startedAt: new Date().toISOString(),
+            completedAt: null,
+            status: "in_progress",
+            generatedIds: [],
+        });
+        session.generation.status = "expanding";
+        await sessionManager.save(session);
+        // Update manifest
+        const manifest = await readManifest(input.sessionId);
+        if (manifest) {
+            addManifestStep(manifest, "expand_npc", `expansions/npc-${input.npcId}.json`);
+            manifest.status = "expanding";
+            await writeManifest(input.sessionId, manifest);
+        }
+        const systemPrompt = `You are expanding an NPC for a tabletop RPG. Add backstory, combat stats (if relevant), quest hooks, and inventory while maintaining the NPC's established identity.
+
+Rules:
+- Backstory should explain how they became who they are
+- Combat stats only for NPCs who might fight (antagonists, guards, etc.)
+- Quest hooks should connect to their motivation and narrative role
+- Inventory should fit their role and economic status
+- Abilities: STR, AGI, WIT, CON (-3 to +3)
+
+Output valid JSON only.`;
+        const userPrompt = `Expand this NPC with additional detail:
+
+World: ${worldSeed.name}
+Tone: ${worldSeed.aesthetic.tone}
+Themes: ${worldSeed.aesthetic.themes.join(", ")}
+Core Conflict: ${worldSeed.coreConflict}
+Lethality: ${worldSeed.settings.lethality}
+
+NPC to expand:
+- ID: ${npc.id}
+- Name: ${npc.name}
+- Description: ${npc.description}
+- Personality: ${npc.personality}
+- Motivation: ${npc.motivation}
+- Attitude: ${npc.attitude}
+- Narrative Role: ${npc.narrativeRole}
+- Dialogue Hints: ${npc.dialogueHints.join("; ")}
+${npc.secrets ? `- Secrets: ${npc.secrets.join("; ")}` : ""}
+
+Available items for inventory:
+${items.slice(0, 20).map(i => `- ${i.id}: ${i.name} (${i.kind})`).join("\n")}
+
+Output a JSON object with the expanded NPC (include ALL original fields plus new ones):
+{
+  "expandedNPC": {
+    "id": "${npc.id}",
+    "name": "${npc.name}",
+    "description": "${npc.description}",
+    "personality": "${npc.personality}",
+    "motivation": "${npc.motivation}",
+    "attitude": "${npc.attitude}",
+    "dialogueHints": ${JSON.stringify(npc.dialogueHints)},
+    "narrativeRole": "${npc.narrativeRole}",
+    "locations": ${JSON.stringify(npc.locations || [])},
+    "relationships": ${JSON.stringify(npc.relationships || {})},
+    "secrets": ${JSON.stringify(npc.secrets || [])},
+    "backstory": "Detailed backstory explaining their history and how they came to be who they are",
+    "combatStats": {
+      "hp": 10,
+      "armor": 0,
+      "abilities": { "STR": 0, "AGI": 0, "WIT": 0, "CON": 0 },
+      "attacks": [
+        { "name": "Attack Name", "damage": "d6" }
+      ]
+    },
+    "questHooks": [
+      "A quest or task they might offer",
+      "A problem they need help with",
+      "Information they could trade for a favor"
+    ],
+    "inventory": ["item:id-from-list", "item:another-id"]
+  }
+}
+
+Notes:
+- Backstory should be 2-4 sentences
+- Include combatStats only if this NPC might fight (null otherwise)
+- Quest hooks should connect to their motivation
+- Inventory should be 2-5 appropriate items
+
+Return ONLY the JSON object, no markdown formatting.`;
+        return {
+            prompt: {
+                system: systemPrompt,
+                user: userPrompt,
+                outputSchemaName: "ExpandedNPC",
+            },
+            stepId,
+            message: `NPC expansion initiated for ${npc.name}. Execute the prompt and call save_generation_result.`,
+        };
+    },
+};
+export const expandNPCTools = [expandNPCTool];
+//# sourceMappingURL=npc.js.map

package/dist/tools/expansion/npc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"npc.js","sourceRoot":"","sources":["../../../src/tools/expansion/npc.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEpC,OAAO,EACL,cAAc,EACd,YAAY,EACZ,aAAa,EACb,eAAe,GAChB,MAAM,wBAAwB,CAAC;AAEhC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;CACtD,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAiB;IACzC,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,kHAAkH;IAC/H,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE;YACxD,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yBAAyB,EAAE;SAClE;QACD,QAAQ,EAAE,CAAC,WAAW,EAAE,OAAO,CAAC;KACjC;IACD,OAAO,EAAE,KAAK,EAAE,IAAa,EAAE,EAAE;QAC/B,MAAM,KAAK,GAAG,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAEzC,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAC1D,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,sBAAsB,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;QAC3D,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,SAAS,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;QAC3E,CAAC;QAED,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,SAKpC,CAAC;QAEF,eAAe;QACf,MAAM,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC,gBAAgB,CAAC,IAA6B,CAAC;QAC/E,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CACnB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,CAAC,KAAK,CAahB,CAAC;QAEd,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,kBAAkB,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;QACnD,CAAC;QAED,4BAA4B;QAC5B,MAAM,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,IAA6B,CAAC;QACjF,MAAM,eAAe,GAAG,YAAY,CAAC,IAAI,CACvC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,CAAC,KAAK,CAC5B,CAAC;QACF,IAAI,eAAe,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,yBAAyB,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;QAC1D,CAAC;QAED,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;QAE5B,0BAA0B;QAC1B,MAAM,KAAK,GAAG,OAAO,CAAC,UAAU,CAAC,gBAAgB,CAAC,KAIhD,CAAC;QAEH,6BAA6B;QAC7B,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC;YAC9B,EAAE,EAAE,MAAM;YACV,IAAI,EAAE,YAAY;YAClB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,WAAW,EAAE,IAAI;YACjB,MAAM,EAAE,aAAa;YACrB,YAAY,EAAE,EAAE;SACjB,CAAC,CAAC;QACH,OAAO,CAAC,UAAU,CAAC,MAAM,GAAG,WAAW,CAAC;QACxC,MAAM,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAEnC,kBAAkB;QAClB,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACrD,IAAI,QAAQ,EAAE,CAAC;YACb,eAAe,CAAC,QAAQ,EAAE,YAAY,EAAE,kBAAkB,KAAK,CAAC,KAAK,OAAO,CAAC,CAAC;YAC9E,QAAQ,CAAC,MAAM,GAAG,WAAW,CAAC;YAC9B,MAAM,aAAa,CAAC,KAAK,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QACjD,CAAC;QAED,MAAM,YAAY,GAAG;;;;;;;;;wBASD,CAAC;QAErB,MAAM,UAAU,GAAG;;SAEd,SAAS,CAAC,IAAI;QACf,SAAS,CAAC,SAAS,CAAC,IAAI;UACtB,SAAS,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;iBAC9B,SAAS,CAAC,YAAY;aAC1B,SAAS,CAAC,QAAQ,CAAC,SAAS;;;QAGjC,GAAG,CAAC,EAAE;UACJ,GAAG,CAAC,IAAI;iBACD,GAAG,CAAC,WAAW;iBACf,GAAG,CAAC,WAAW;gBAChB,GAAG,CAAC,UAAU;cAChB,GAAG,CAAC,QAAQ;oBACN,GAAG,CAAC,aAAa;oBACjB,GAAG,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC;EAC9C,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE;;;EAGzD,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;aAK/D,GAAG,CAAC,EAAE;eACJ,GAAG,CAAC,IAAI;sBACD,GAAG,CAAC,WAAW;sBACf,GAAG,CAAC,WAAW;qBAChB,GAAG,CAAC,UAAU;mBAChB,GAAG,CAAC,QAAQ;uBACR,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,aAAa,CAAC;wBAChC,GAAG,CAAC,aAAa;mBACtB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC;uBAC/B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,aAAa,IAAI,EAAE,CAAC;iBAC7C,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;qDAyBG,CAAC;QAElD,OAAO;YACL,MAAM,EAAE;gBACN,MAAM,EAAE,YAAY;gBACpB,IAAI,EAAE,UAAU;gBAChB,gBAAgB,EAAE,aAAa;aAChC;YACD,MAAM;YACN,OAAO,EAAE,+BAA+B,GAAG,CAAC,IAAI,uDAAuD;SACxG,CAAC;IACJ,CAAC;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,aAAa,CAAC,CAAC"}

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

@@ -0,0 +1,12 @@
+/**
+ * Archetype Generation Tool
+ *
+ * Generates playable character archetypes based on the world seed.
+ */
+import type { MCPToolEntry } from "@mythxengine/types";
+/**
+ * generate_archetypes tool
+ */
+export declare const generateArchetypesTool: MCPToolEntry;
+export declare const archetypeTools: MCPToolEntry[];
+//# sourceMappingURL=archetypes.d.ts.map

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

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

package/dist/tools/generation/archetypes.js

@@ -0,0 +1,129 @@
+/**
+ * Archetype Generation Tool
+ *
+ * Generates playable character archetypes based on the world seed.
+ */
+import { z } from "zod";
+import { randomUUID } from "crypto";
+import { sessionManager, readManifest, writeManifest, addManifestStep, } from "../../state/manager.js";
+import { buildRulesPromptSection, buildHPGuidelines } from "./rules-prompt.js";
+const GenerateArchetypesInput = z.object({
+    sessionId: z.string(),
+    count: z.number().min(1).max(10).optional().describe("Number of archetypes to generate (default: from world seed)"),
+    focusOn: z.array(z.string()).optional().describe("Specific archetype seeds to focus on (by name)"),
+});
+/**
+ * generate_archetypes tool
+ */
+export const generateArchetypesTool = {
+    name: "generate_archetypes",
+    description: "Generate playable character archetypes 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 archetypes to generate (default: from world seed)" },
+            focusOn: { type: "array", items: { type: "string" }, description: "Specific archetype seeds to focus on (by name)" },
+        },
+        required: ["sessionId"],
+    },
+    handler: async (args) => {
+        const input = GenerateArchetypesInput.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 archetypeSeeds = input.focusOn
+            ? worldSeed.archetypeSeeds.filter(a => input.focusOn.includes(a.name))
+            : worldSeed.archetypeSeeds;
+        const count = input.count || archetypeSeeds.length;
+        // Record the generation step
+        session.generation.history.push({
+            id: stepId,
+            type: "archetypes",
+            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, "archetypes", "archetypes.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 hpGuidelines = buildHPGuidelines(worldSeed.rules);
+        const systemPrompt = `You are a character archetype designer for tabletop RPGs. Create compelling, balanced archetypes that fit the world's tone and offer distinct playstyles.
+
+${rulesSection}
+
+${hpGuidelines}
+
+Design Guidelines:
+- Ability modifiers should sum to approximately +2 total
+- Each archetype needs 2 unique features
+- Starting items should be 3-5 thematic items (reference by ID like "item:weapon-name")
+- Playstyle guidance should help players understand the archetype's role
+
+Output valid JSON only.`;
+        const userPrompt = `Generate ${count} playable character archetypes for this world:
+
+World: ${worldSeed.name}
+Tagline: ${worldSeed.tagline}
+Tone: ${worldSeed.aesthetic.tone}
+Themes: ${worldSeed.aesthetic.themes.join(", ")}
+Core Conflict: ${worldSeed.coreConflict}
+Lethality: ${worldSeed.settings.lethality}
+Magic Level: ${worldSeed.settings.magicLevel}
+
+Archetype seeds to develop:
+${archetypeSeeds.map((a, i) => `${i + 1}. ${a.name}: ${a.concept}`).join("\n")}
+
+Output a JSON object:
+{
+  "archetypes": [
+    {
+      "id": "archetype:slug-name",
+      "name": "Archetype Name",
+      "tagline": "Short hook",
+      "description": "2-3 sentences describing the archetype",
+      "starting": {
+        "abilities": { "STR": 0, "AGI": 0, "WIT": 0, "CON": 0 },
+        "hp": 10,
+        "maxHp": 10
+      },
+      "startingItems": ["item:weapon-id", "item:armor-id", "item:gear-id"],
+      "features": [
+        { "id": "feature:feature-id", "name": "Feature Name", "description": "What it does" }
+      ],
+      "playstyle": "How to play this archetype effectively",
+      "background": "Lore and backstory for this archetype",
+      "flavor": "Evocative one-liner"
+    }
+  ]
+}
+
+Return ONLY the JSON object, no markdown formatting.`;
+        return {
+            prompt: {
+                system: systemPrompt,
+                user: userPrompt,
+                outputSchemaName: "WorldArchetype[]",
+            },
+            stepId,
+            message: `Archetype generation initiated for ${count} archetypes. Execute the prompt and call save_generation_result.`,
+        };
+    },
+};
+export const archetypeTools = [generateArchetypesTool];
+//# sourceMappingURL=archetypes.js.map

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

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

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

@@ -0,0 +1,13 @@
+/**
+ * Arc Generation Tool
+ *
+ * Generates story arcs that group related situations around a central tension.
+ * Arcs provide structure for multi-session storylines.
+ */
+import type { MCPToolEntry } from "@mythxengine/types";
+/**
+ * generate_arcs tool
+ */
+export declare const generateArcsTool: MCPToolEntry;
+export declare const arcTools: MCPToolEntry[];
+//# sourceMappingURL=arcs.d.ts.map

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

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

package/dist/tools/generation/arcs.js

@@ -0,0 +1,186 @@
+/**
+ * Arc Generation Tool
+ *
+ * Generates story arcs that group related situations around a central tension.
+ * Arcs provide structure for multi-session storylines.
+ */
+import { z } from "zod";
+import { randomUUID } from "crypto";
+import { sessionManager, readManifest, writeManifest, addManifestStep, } from "../../state/manager.js";
+const GenerateArcsInput = z.object({
+    sessionId: z.string(),
+    count: z.number().min(1).max(10).optional().describe("Number of arcs to generate (default: from world seed or 2)"),
+    focusOn: z.array(z.string()).optional().describe("Specific arc seeds to focus on (by name)"),
+});
+/**
+ * generate_arcs tool
+ */
+export const generateArcsTool = {
+    name: "generate_arcs",
+    description: "Generate story arcs that group situations around central tensions. Returns a prompt for LLM execution.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            sessionId: { type: "string", description: "Session ID" },
+            count: { type: "number", description: "Number of arcs to generate" },
+            focusOn: { type: "array", items: { type: "string" }, description: "Specific arc seeds to focus on" },
+        },
+        required: ["sessionId"],
+    },
+    handler: async (args) => {
+        const input = GenerateArcsInput.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 situations for references
+        const existingSituations = session.generation.generatedContent.situations;
+        if (existingSituations.length === 0) {
+            throw new Error("No situations found. Call generate_situations first to create situations to group into arcs.");
+        }
+        const stepId = randomUUID();
+        const arcSeeds = input.focusOn && worldSeed.arcSeeds
+            ? worldSeed.arcSeeds.filter(a => input.focusOn.includes(a.name))
+            : worldSeed.arcSeeds || [];
+        const count = input.count || arcSeeds.length || 2;
+        // Record the generation step
+        session.generation.history.push({
+            id: stepId,
+            type: "arcs",
+            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, "arcs", "arcs.json");
+            manifest.status = "generating";
+            await writeManifest(input.sessionId, manifest);
+        }
+        const systemPrompt = `You are a narrative architect for tabletop RPGs. You create story arcs that organize situations into meaningful campaigns.
+
+An ARC groups related situations around a central tension. Arcs provide:
+- Structure for pacing (funnel, layer-cake, hub-spoke, chain, web)
+- Clear opposing forces and conflicts
+- Resolution patterns for satisfying conclusions
+- GM guidance for running the arc
+
+Arc Structure Types:
+- FUNNEL: Multiple entry points that narrow toward a single climax
+- LAYER_CAKE: Situations unlock in layers (solve layer 1 to access layer 2)
+- HUB_SPOKE: Central hub situation with satellite situations
+- CHAIN: Linear progression from start to finish
+- WEB: Interconnected without clear structure
+
+Output valid JSON only.`;
+        const situationList = existingSituations.map(s => `- ${s.id}: ${s.name} - ${s.description.substring(0, 100)}...${s.layer !== undefined ? ` (layer ${s.layer})` : ""}`).join("\n");
+        const userPrompt = `Generate ${count} story arc(s) for this world:
+
+World: ${worldSeed.name}
+Tone: ${worldSeed.aesthetic.tone}
+Themes: ${worldSeed.aesthetic.themes.join(", ")}
+Core Conflict: ${worldSeed.coreConflict}
+
+${arcSeeds.length > 0 ? `Arc seeds to develop:\n${arcSeeds.slice(0, count).map((a, i) => `${i + 1}. ${a.name}: ${a.concept}${a.structure ? ` (structure: ${a.structure})` : ""}`).join("\n")}` : "Create arcs that explore the core conflict from different angles."}
+
+Existing Situations to organize into arcs:
+${situationList}
+
+NPCs available for key roles:
+${worldSeed.npcSeeds.map(n => `- ${n.name}: ${n.concept}`).join("\n")}
+
+Output a JSON object:
+{
+  "arcs": [
+    {
+      "id": "arc:slug-name",
+      "name": "Arc Name",
+      "description": "Overview of this storyline",
+
+      "tension": {
+        "centralConflict": "The core conflict of this arc",
+        "source": "Where the conflict originates",
+        "opposingForces": [
+          {
+            "name": "Force Name",
+            "goal": "What they want",
+            "factionId": "faction:id-if-applicable"
+          }
+        ],
+        "urgency": "Why this matters now"
+      },
+
+      "situationIds": ["situation:id-1", "situation:id-2"],
+
+      "structure": {
+        "type": "funnel|layer_cake|hub_spoke|chain|web",
+        "layers": {
+          "situation:id-1": 1,
+          "situation:id-2": 2
+        },
+        "entryPoints": ["situation:entry-1"],
+        "climax": "situation:climax-id",
+        "hub": "situation:hub-id",
+        "suggestedOrder": ["situation:first", "situation:second"]
+      },
+
+      "resolution": {
+        "patterns": [
+          {
+            "name": "Victory Pattern",
+            "description": "How the arc concludes positively",
+            "triggerConditions": ["All antagonists defeated", "Key artifact secured"]
+          },
+          {
+            "name": "Pyrrhic Victory",
+            "description": "Win at a cost",
+            "triggerConditions": ["Main threat stopped but ally lost"]
+          }
+        ],
+        "unlocksArcs": ["arc:sequel-arc-id"],
+        "worldChanges": ["Major change 1", "Major change 2"]
+      },
+
+      "themes": ["Theme 1", "Theme 2"],
+
+      "gmGuidance": {
+        "introduction": "How to introduce this arc to players",
+        "pacing": "Advice on running this arc over multiple sessions",
+        "keyNpcs": ["npc:key-character-1", "npc:key-character-2"],
+        "atmosphere": "The feel and mood to maintain"
+      },
+
+      "status": "dormant"
+    }
+  ]
+}
+
+IMPORTANT:
+- Reference actual situation IDs from the existing situations list
+- Choose appropriate structure type for the arc's pacing needs
+- Include multiple resolution patterns for player agency
+- Key NPCs should drive the narrative
+- World changes should be meaningful consequences
+
+Return ONLY the JSON object, no markdown formatting.`;
+        return {
+            prompt: {
+                system: systemPrompt,
+                user: userPrompt,
+                outputSchemaName: "WorldArc[]",
+            },
+            stepId,
+            message: `Arc generation initiated for ${count} arc(s). Execute the prompt and call save_generation_result.`,
+        };
+    },
+};
+export const arcTools = [generateArcsTool];
+//# sourceMappingURL=arcs.js.map

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

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

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

@@ -0,0 +1,12 @@
+/**
+ * Encounter Generation Tool
+ *
+ * Generates encounters based on the world seed.
+ */
+import type { MCPToolEntry } from "@mythxengine/types";
+/**
+ * generate_encounters tool
+ */
+export declare const generateEncountersTool: MCPToolEntry;
+export declare const encounterTools: MCPToolEntry[];
+//# sourceMappingURL=encounters.d.ts.map

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

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