@mythxengine/mcp-server 0.1.0

package/dist/tools/worldpack/manage.d.ts

@@ -0,0 +1,20 @@
+/**
+ * World Pack Management Tools
+ *
+ * List, load, and delete world packs.
+ */
+import type { MCPToolEntry } from "@mythxengine/types";
+/**
+ * list_world_packs tool
+ */
+export declare const listWorldPacksTool: MCPToolEntry;
+/**
+ * load_world_pack tool
+ */
+export declare const loadWorldPackTool: MCPToolEntry;
+/**
+ * delete_world_pack tool
+ */
+export declare const deleteWorldPackTool: MCPToolEntry;
+export declare const manageTools: MCPToolEntry[];
+//# sourceMappingURL=manage.d.ts.map

package/dist/tools/worldpack/manage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manage.d.ts","sourceRoot":"","sources":["../../../src/tools/worldpack/manage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAWvD;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,YAmChC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,YAsB/B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,YAyBjC,CAAC;AAEF,eAAO,MAAM,WAAW,gBAA+D,CAAC"}

package/dist/tools/worldpack/manage.js

@@ -0,0 +1,101 @@
+/**
+ * World Pack Management Tools
+ *
+ * List, load, and delete world packs.
+ */
+import { z } from "zod";
+import { worldPackManager } from "../../state/worldpacks.js";
+const LoadWorldPackInput = z.object({
+    packId: z.string(),
+});
+const DeleteWorldPackInput = z.object({
+    packId: z.string(),
+});
+/**
+ * list_world_packs tool
+ */
+export const listWorldPacksTool = {
+    name: "list_world_packs",
+    description: "List all saved world packs.",
+    inputSchema: {
+        type: "object",
+        properties: {},
+    },
+    handler: async () => {
+        const packIds = await worldPackManager.list();
+        const packs = await Promise.all(packIds.map(async (id) => {
+            const pack = await worldPackManager.get(id);
+            if (!pack)
+                return null;
+            return {
+                id: pack.meta.id,
+                name: pack.meta.name,
+                tagline: pack.meta.tagline,
+                contentCounts: {
+                    archetypes: Object.keys(pack.archetypes).length,
+                    monsters: Object.keys(pack.monsters).length,
+                    items: Object.keys(pack.items).length,
+                    encounters: Object.keys(pack.encounters).length,
+                    locations: Object.keys(pack.locations).length,
+                    npcs: Object.keys(pack.npcs).length,
+                },
+            };
+        }));
+        return {
+            count: packs.filter(Boolean).length,
+            packs: packs.filter(Boolean),
+        };
+    },
+};
+/**
+ * load_world_pack tool
+ */
+export const loadWorldPackTool = {
+    name: "load_world_pack",
+    description: "Load a saved world pack by ID.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            packId: { type: "string", description: "Pack ID to load" },
+        },
+        required: ["packId"],
+    },
+    handler: async (args) => {
+        const input = LoadWorldPackInput.parse(args);
+        const pack = await worldPackManager.get(input.packId);
+        if (!pack) {
+            throw new Error(`World pack not found: ${input.packId}`);
+        }
+        return {
+            pack,
+        };
+    },
+};
+/**
+ * delete_world_pack tool
+ */
+export const deleteWorldPackTool = {
+    name: "delete_world_pack",
+    description: "Delete a saved world pack.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            packId: { type: "string", description: "Pack ID to delete" },
+        },
+        required: ["packId"],
+    },
+    handler: async (args) => {
+        const input = DeleteWorldPackInput.parse(args);
+        const pack = await worldPackManager.get(input.packId);
+        if (!pack) {
+            throw new Error(`World pack not found: ${input.packId}`);
+        }
+        await worldPackManager.delete(input.packId);
+        return {
+            message: `World pack deleted: ${pack.meta.name}`,
+            packId: input.packId,
+        };
+    },
+};
+export const manageTools = [listWorldPacksTool, loadWorldPackTool, deleteWorldPackTool];
+//# sourceMappingURL=manage.js.map

package/dist/tools/worldpack/manage.js.map

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

package/dist/tools/worldpack/save-result.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Save Generation Result Tool
+ *
+ * Saves LLM-generated content back to the session.
+ */
+import type { MCPToolEntry } from "@mythxengine/types";
+/**
+ * save_generation_result tool
+ */
+export declare const saveGenerationResultTool: MCPToolEntry;
+export declare const saveResultTools: MCPToolEntry[];
+//# sourceMappingURL=save-result.d.ts.map

package/dist/tools/worldpack/save-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"save-result.d.ts","sourceRoot":"","sources":["../../../src/tools/worldpack/save-result.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AA2CvD;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAE,YAyPtC,CAAC;AAEF,eAAO,MAAM,eAAe,gBAA6B,CAAC"}

package/dist/tools/worldpack/save-result.js

@@ -0,0 +1,222 @@
+/**
+ * Save Generation Result Tool
+ *
+ * Saves LLM-generated content back to the session.
+ */
+import { z } from "zod";
+import { WorldSeedSchema, WorldArchetypeSchema, WorldMonsterSchema, WorldItemSchema, WorldEncounterSchema, WorldLocationSchema, WorldNPCSchema, NarrativeGuidanceSchema, ExpandedLocationSchema, ExpandedArchetypeSchema, ExpandedNPCSchema, ExpandedMonsterSchema, WorldSituationSchema, WorldArcSchema, } from "@mythxengine/worlds";
+import { sessionManager, readManifest, writeManifest, writeStepFile, } from "../../state/manager.js";
+const SaveGenerationResultInput = z.object({
+    sessionId: z.string(),
+    stepId: z.string().describe("Step ID from the generation tool response"),
+    result: z.unknown().describe("The LLM-generated JSON result"),
+});
+/**
+ * Get the file path for a step type
+ */
+function getStepFilename(stepType, entityId) {
+    if (stepType.startsWith("expand_")) {
+        // Expansion steps go to expansions/{type}-{id}.json
+        const baseType = stepType.replace("expand_", "");
+        return `expansions/${baseType}-${entityId}.json`;
+    }
+    // Base content steps go to {type}.json
+    return `${stepType}.json`;
+}
+/**
+ * save_generation_result tool
+ */
+export const saveGenerationResultTool = {
+    name: "save_generation_result",
+    description: "Save LLM-generated content back to the session. Call this after executing a generation prompt.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            sessionId: { type: "string", description: "Session ID" },
+            stepId: { type: "string", description: "Step ID from the generation tool response" },
+            result: { description: "The LLM-generated JSON result" },
+        },
+        required: ["sessionId", "stepId", "result"],
+    },
+    handler: async (args) => {
+        const input = SaveGenerationResultInput.parse(args);
+        const session = await sessionManager.get(input.sessionId);
+        if (!session) {
+            throw new Error(`Session not found: ${input.sessionId}`);
+        }
+        if (!session.generation) {
+            throw new Error("No generation session found");
+        }
+        // Find the step
+        const step = session.generation.history.find(s => s.id === input.stepId);
+        if (!step) {
+            throw new Error(`Step not found: ${input.stepId}`);
+        }
+        if (step.status === "completed") {
+            throw new Error(`Step already completed: ${input.stepId}`);
+        }
+        // Parse result based on step type
+        let parsedResult;
+        const result = input.result;
+        try {
+            switch (step.type) {
+                case "seed": {
+                    parsedResult = WorldSeedSchema.parse(result);
+                    session.generation.worldSeed = parsedResult;
+                    step.generatedIds = [parsedResult.id];
+                    break;
+                }
+                case "archetypes": {
+                    const archetypes = z.array(WorldArchetypeSchema).parse(result.archetypes || result);
+                    session.generation.generatedContent.archetypes.push(...archetypes);
+                    step.generatedIds = archetypes.map(a => a.id);
+                    break;
+                }
+                case "monsters": {
+                    const monsters = z.array(WorldMonsterSchema).parse(result.monsters || result);
+                    session.generation.generatedContent.monsters.push(...monsters);
+                    step.generatedIds = monsters.map(m => m.id);
+                    break;
+                }
+                case "items": {
+                    const items = z.array(WorldItemSchema).parse(result.items || result);
+                    session.generation.generatedContent.items.push(...items);
+                    step.generatedIds = items.map(i => i.id);
+                    break;
+                }
+                case "encounters": {
+                    const encounters = z.array(WorldEncounterSchema).parse(result.encounters || result);
+                    session.generation.generatedContent.encounters.push(...encounters);
+                    step.generatedIds = encounters.map(e => e.id);
+                    break;
+                }
+                case "locations": {
+                    const locations = z.array(WorldLocationSchema).parse(result.locations || result);
+                    session.generation.generatedContent.locations.push(...locations);
+                    step.generatedIds = locations.map(l => l.id);
+                    break;
+                }
+                case "npcs": {
+                    const npcs = z.array(WorldNPCSchema).parse(result.npcs || result);
+                    session.generation.generatedContent.npcs.push(...npcs);
+                    step.generatedIds = npcs.map(n => n.id);
+                    break;
+                }
+                case "narrative": {
+                    const narrative = NarrativeGuidanceSchema.parse(result.narrative || result);
+                    session.generation.generatedContent.narrative = narrative;
+                    step.generatedIds = ["narrative"];
+                    break;
+                }
+                case "situations": {
+                    const situations = z.array(WorldSituationSchema).parse(result.situations || result);
+                    session.generation.generatedContent.situations.push(...situations);
+                    step.generatedIds = situations.map(s => s.id);
+                    break;
+                }
+                case "arcs": {
+                    const arcs = z.array(WorldArcSchema).parse(result.arcs || result);
+                    session.generation.generatedContent.arcs.push(...arcs);
+                    step.generatedIds = arcs.map(a => a.id);
+                    break;
+                }
+                case "expand_location": {
+                    const expanded = ExpandedLocationSchema.parse(result.expandedLocation || result);
+                    session.generation.expansions.locations.push(expanded);
+                    step.generatedIds = [expanded.id];
+                    break;
+                }
+                case "expand_archetype": {
+                    const expanded = ExpandedArchetypeSchema.parse(result.expandedArchetype || result);
+                    session.generation.expansions.archetypes.push(expanded);
+                    step.generatedIds = [expanded.id];
+                    break;
+                }
+                case "expand_npc": {
+                    const expanded = ExpandedNPCSchema.parse(result.expandedNPC || result);
+                    session.generation.expansions.npcs.push(expanded);
+                    step.generatedIds = [expanded.id];
+                    break;
+                }
+                case "expand_monster": {
+                    const expanded = ExpandedMonsterSchema.parse(result.expandedMonster || result);
+                    session.generation.expansions.monsters.push(expanded);
+                    step.generatedIds = [expanded.id];
+                    break;
+                }
+                default:
+                    throw new Error(`Unknown step type: ${step.type}`);
+            }
+        }
+        catch (error) {
+            step.status = "failed";
+            step.error = error instanceof Error ? error.message : String(error);
+            step.completedAt = new Date().toISOString();
+            await sessionManager.save(session);
+            // Also update manifest if it exists
+            const manifest = await readManifest(input.sessionId);
+            if (manifest) {
+                // Match by stepId to handle duplicate step types correctly
+                const manifestStep = manifest.steps.find((s) => s.stepId === step.id || (s.type === step.type && !s.stepId));
+                if (manifestStep) {
+                    manifestStep.stepId = step.id; // Ensure stepId is persisted
+                    manifestStep.status = "failed";
+                    manifestStep.error = step.error;
+                    manifestStep.completedAt = step.completedAt;
+                    await writeManifest(input.sessionId, manifest);
+                }
+            }
+            throw error;
+        }
+        // Mark step complete
+        step.status = "completed";
+        step.completedAt = new Date().toISOString();
+        // Update overall status
+        const hasInProgress = session.generation.history.some(s => s.status === "in_progress");
+        if (!hasInProgress) {
+            if (session.generation.status === "seeding") {
+                session.generation.status = "generating";
+            }
+            else if (session.generation.status === "expanding") {
+                // Check if we have all expansions
+                const allExpanded = true; // Could add more sophisticated checking
+                if (allExpanded) {
+                    session.generation.status = "generating";
+                }
+            }
+        }
+        await sessionManager.save(session);
+        // Write step file and update manifest
+        const entityId = step.generatedIds?.[0];
+        const filename = getStepFilename(step.type, entityId);
+        // Write the parsed result to step file
+        await writeStepFile(input.sessionId, filename, parsedResult);
+        // Update manifest
+        const manifest = await readManifest(input.sessionId);
+        if (manifest) {
+            // Match by stepId to handle duplicate step types correctly
+            const manifestStep = manifest.steps.find((s) => s.stepId === step.id || (s.type === step.type && !s.stepId));
+            if (manifestStep) {
+                manifestStep.stepId = step.id; // Ensure stepId is persisted
+                manifestStep.status = "completed";
+                manifestStep.completedAt = step.completedAt;
+                manifestStep.generatedIds = step.generatedIds;
+                manifestStep.file = filename;
+            }
+            // Update manifest status to match session status (except idle which isn't valid for manifest)
+            if (session.generation.status !== "idle") {
+                manifest.status = session.generation.status;
+            }
+            await writeManifest(input.sessionId, manifest);
+        }
+        return {
+            message: `Saved ${step.type} result`,
+            stepId: step.id,
+            generatedIds: step.generatedIds,
+            status: session.generation.status,
+            file: filename,
+        };
+    },
+};
+export const saveResultTools = [saveGenerationResultTool];
+//# sourceMappingURL=save-result.js.map

package/dist/tools/worldpack/save-result.js.map

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

package/dist/tools/worldpack/summary.d.ts

@@ -0,0 +1,13 @@
+/**
+ * World Pack Summary Tool
+ *
+ * Returns a compact, token-efficient GM reference for gameplay.
+ * Use lookup tools (get_archetype, get_location, etc.) for full entity details.
+ */
+import type { MCPToolEntry } from "@mythxengine/types";
+/**
+ * load_world_summary tool
+ */
+export declare const loadWorldSummaryTool: MCPToolEntry;
+export declare const summaryTools: MCPToolEntry[];
+//# sourceMappingURL=summary.d.ts.map

package/dist/tools/worldpack/summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary.d.ts","sourceRoot":"","sources":["../../../src/tools/worldpack/summary.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAoKvD;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,YA0BlC,CAAC;AAEF,eAAO,MAAM,YAAY,gBAAyB,CAAC"}

package/dist/tools/worldpack/summary.js

@@ -0,0 +1,180 @@
+/**
+ * World Pack Summary Tool
+ *
+ * Returns a compact, token-efficient GM reference for gameplay.
+ * Use lookup tools (get_archetype, get_location, etc.) for full entity details.
+ */
+import { z } from "zod";
+import { worldPackManager } from "../../state/worldpacks.js";
+const LoadWorldSummaryInput = z.object({
+    packId: z.string().describe("Pack ID to load"),
+});
+/**
+ * Generate a compact markdown summary of a world pack
+ */
+function generateWorldSummary(pack) {
+    const lines = [];
+    // Header
+    lines.push(`# ${pack.meta.name}`);
+    lines.push(`*${pack.meta.tagline}*`);
+    lines.push("");
+    // World settings (compact)
+    lines.push("## World");
+    lines.push(`- **Tone**: ${pack.meta.aesthetic.tone} | **Magic**: ${pack.meta.settings.magicLevel} | **Lethality**: ${pack.meta.settings.lethality}`);
+    lines.push(`- **Themes**: ${pack.meta.aesthetic.themes.join(", ")}`);
+    lines.push("");
+    // Archetypes table
+    const archetypes = Object.values(pack.archetypes);
+    lines.push(`## Archetypes (${archetypes.length})`);
+    lines.push("| ID | Name | Tagline | HP | Key Ability |");
+    lines.push("|----|------|---------|-----|-------------|");
+    for (const a of archetypes) {
+        const abilities = a.starting.abilities;
+        const keyAbility = Object.entries(abilities)
+            .filter(([_, v]) => v > 0)
+            .sort((a, b) => b[1] - a[1])
+            .map(([k, v]) => `${k}+${v}`)
+            .join(", ") || "balanced";
+        lines.push(`| ${a.id} | ${a.name} | ${a.tagline} | ${a.starting.hp} | ${keyAbility} |`);
+    }
+    lines.push("");
+    // Locations table
+    const locations = Object.values(pack.locations);
+    lines.push(`## Locations (${locations.length})`);
+    lines.push("| ID | Name | Type | Connects To |");
+    lines.push("|----|------|------|-------------|");
+    for (const loc of locations) {
+        const connections = loc.connections.length > 0 ? loc.connections.join(", ") : "-";
+        lines.push(`| ${loc.id} | ${loc.name} | ${loc.type} | ${connections} |`);
+    }
+    lines.push("");
+    // NPCs table
+    const npcs = Object.values(pack.npcs);
+    lines.push(`## NPCs (${npcs.length})`);
+    lines.push("| ID | Name | Role | Attitude | Locations |");
+    lines.push("|----|------|------|----------|-----------|");
+    for (const npc of npcs) {
+        const locs = npc.locations?.join(", ") || "-";
+        lines.push(`| ${npc.id} | ${npc.name} | ${npc.narrativeRole} | ${npc.attitude} | ${locs} |`);
+    }
+    lines.push("");
+    // Monsters table
+    const monsters = Object.values(pack.monsters);
+    lines.push(`## Monsters (${monsters.length})`);
+    lines.push("| ID | Name | Threat | HP | Armor |");
+    lines.push("|----|------|--------|-----|-------|");
+    for (const m of monsters) {
+        lines.push(`| ${m.id} | ${m.name} | ${m.threat} | ${m.hp} | ${m.armor} |`);
+    }
+    lines.push("");
+    // Items table (compact - name and type only)
+    const items = Object.values(pack.items);
+    lines.push(`## Items (${items.length})`);
+    lines.push("| ID | Name | Type |");
+    lines.push("|----|------|------|");
+    for (const item of items) {
+        lines.push(`| ${item.id} | ${item.name} | ${item.kind} |`);
+    }
+    lines.push("");
+    // Encounters table
+    const encounters = Object.values(pack.encounters);
+    lines.push(`## Encounters (${encounters.length})`);
+    lines.push("| ID | Type | Name |");
+    lines.push("|----|------|------|");
+    for (const enc of encounters) {
+        lines.push(`| ${enc.id} | ${enc.type} | ${enc.name} |`);
+    }
+    lines.push("");
+    // Conditions table
+    const conditions = Object.values(pack.conditions);
+    if (conditions.length > 0) {
+        lines.push(`## Conditions (${conditions.length})`);
+        lines.push("| ID | Name | Duration |");
+        lines.push("|----|------|----------|");
+        for (const cond of conditions) {
+            const dur = typeof cond.duration === "number" ? `${cond.duration} rounds` : cond.duration;
+            lines.push(`| ${cond.id} | ${cond.name} | ${dur} |`);
+        }
+        lines.push("");
+    }
+    // Factions table (if present)
+    const factions = pack.factions ? Object.values(pack.factions) : [];
+    if (factions.length > 0) {
+        lines.push(`## Factions (${factions.length})`);
+        lines.push("| ID | Name | Goal |");
+        lines.push("|----|------|------|");
+        for (const faction of factions) {
+            const goal = faction.goals[0] || "-";
+            lines.push(`| ${faction.id} | ${faction.name} | ${goal} |`);
+        }
+        lines.push("");
+    }
+    // Situations table (if present)
+    const situations = pack.situations ? Object.values(pack.situations) : [];
+    if (situations.length > 0) {
+        lines.push(`## Situations (${situations.length})`);
+        lines.push("| ID | Name | Status | Clock |");
+        lines.push("|----|------|--------|-------|");
+        for (const sit of situations) {
+            let clockInfo = "-";
+            if (sit.clock) {
+                clockInfo = sit.clock.doom;
+            }
+            lines.push(`| ${sit.id} | ${sit.name} | ${sit.status} | ${clockInfo} |`);
+        }
+        lines.push("");
+    }
+    // Arcs table (if present)
+    const arcs = pack.arcs ? Object.values(pack.arcs) : [];
+    if (arcs.length > 0) {
+        lines.push(`## Arcs (${arcs.length})`);
+        lines.push("| ID | Name | Status | Structure |");
+        lines.push("|----|------|--------|-----------|");
+        for (const arc of arcs) {
+            lines.push(`| ${arc.id} | ${arc.name} | ${arc.status} | ${arc.structure.type} |`);
+        }
+        lines.push("");
+    }
+    // Narrative hooks
+    lines.push("## Narrative Hooks");
+    for (const hook of pack.narrativeGuidance.plotHooks.slice(0, 5)) {
+        lines.push(`- ${hook}`);
+    }
+    lines.push("");
+    // Opening scenes (first 3)
+    lines.push("## Opening Scenes");
+    for (const scene of pack.narrativeGuidance.openingScenes.slice(0, 3)) {
+        lines.push(`- ${scene}`);
+    }
+    lines.push("");
+    return lines.join("\n");
+}
+/**
+ * load_world_summary tool
+ */
+export const loadWorldSummaryTool = {
+    name: "load_world_summary",
+    description: "Load a compact GM reference for a world pack. Returns a token-efficient summary with entity IDs, names, and key stats. Use get_* tools (get_archetype, get_location, etc.) for full entity details.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            packId: { type: "string", description: "Pack ID to load" },
+        },
+        required: ["packId"],
+    },
+    handler: async (args) => {
+        const input = LoadWorldSummaryInput.parse(args);
+        const pack = await worldPackManager.get(input.packId);
+        if (!pack) {
+            throw new Error(`World pack not found: ${input.packId}`);
+        }
+        const summary = generateWorldSummary(pack);
+        return {
+            packId: input.packId,
+            name: pack.meta.name,
+            summary,
+        };
+    },
+};
+export const summaryTools = [loadWorldSummaryTool];
+//# sourceMappingURL=summary.js.map

package/dist/tools/worldpack/summary.js.map

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

package/dist/tools/worldpack/validate.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Validate World Pack Tool
+ *
+ * Checks a world pack for completeness and consistency.
+ */
+import type { MCPToolEntry } from "@mythxengine/types";
+/**
+ * validate_world_pack tool
+ */
+export declare const validateWorldPackTool: MCPToolEntry;
+export declare const validateTools: MCPToolEntry[];
+//# sourceMappingURL=validate.d.ts.map

package/dist/tools/worldpack/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../src/tools/worldpack/validate.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAUvD;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,YAmDnC,CAAC;AA0XF,eAAO,MAAM,aAAa,gBAA0B,CAAC"}