@mythxengine/mcp-server 0.1.0

package/dist/tools/players.js

@@ -0,0 +1,448 @@
+/**
+ * Player management tools - CRUD operations for players
+ */
+import { z } from "zod";
+import { createPlayer, createDefaultAIPersona } from "@mythxengine/types";
+import { sessionManager } from "../state/manager.js";
+// Input schemas
+const CreatePlayerInput = z.object({
+    sessionId: z.string(),
+    id: z.string(),
+    name: z.string(),
+    role: z.enum(["gm", "pc", "spectator"]),
+    controlType: z.enum(["human", "ai"]),
+    characterId: z.string().optional(),
+    aiPersona: z
+        .object({
+        playstyle: z.enum(["tactical", "roleplay", "cautious", "reckless"]),
+        talkativeness: z.number().min(0).max(10).optional().default(5),
+        personalityNotes: z.string().optional(),
+    })
+        .optional(),
+});
+const GetPlayerInput = z.object({
+    sessionId: z.string(),
+    playerId: z.string(),
+});
+const ListPlayersInput = z.object({
+    sessionId: z.string(),
+});
+const UpdatePlayerInput = z.object({
+    sessionId: z.string(),
+    playerId: z.string(),
+    name: z.string().optional(),
+    status: z.enum(["active", "inactive", "waiting_for_input"]).optional(),
+    characterId: z.string().nullable().optional(),
+    aiPersona: z
+        .object({
+        playstyle: z.enum(["tactical", "roleplay", "cautious", "reckless"]).optional(),
+        talkativeness: z.number().min(0).max(10).optional(),
+        personalityNotes: z.string().optional(),
+    })
+        .optional(),
+});
+const DeletePlayerInput = z.object({
+    sessionId: z.string(),
+    playerId: z.string(),
+});
+const AssignCharacterInput = z.object({
+    sessionId: z.string(),
+    playerId: z.string(),
+    characterId: z.string(),
+});
+/**
+ * Ensure session has players map initialized
+ */
+function ensurePlayersMap(session) {
+    if (!session.players) {
+        session.players = {};
+    }
+    return session.players;
+}
+/**
+ * create_player tool
+ */
+export const createPlayerTool = {
+    name: "create_player",
+    description: "Add a player (human or AI) to the session",
+    inputSchema: {
+        type: "object",
+        properties: {
+            sessionId: { type: "string", description: "Session ID" },
+            id: { type: "string", description: "Unique player ID" },
+            name: { type: "string", description: "Display name" },
+            role: {
+                type: "string",
+                enum: ["gm", "pc", "spectator"],
+                description: "Player role (gm, pc, or spectator)",
+            },
+            controlType: {
+                type: "string",
+                enum: ["human", "ai"],
+                description: "Human or AI controlled",
+            },
+            characterId: {
+                type: "string",
+                description: "Character ID to link (optional)",
+            },
+            aiPersona: {
+                type: "object",
+                properties: {
+                    playstyle: {
+                        type: "string",
+                        enum: ["tactical", "roleplay", "cautious", "reckless"],
+                        description: "AI playstyle",
+                    },
+                    talkativeness: {
+                        type: "number",
+                        minimum: 0,
+                        maximum: 10,
+                        description: "How much the AI talks in-character (0-10)",
+                    },
+                    personalityNotes: {
+                        type: "string",
+                        description: "Additional personality notes for the AI",
+                    },
+                },
+                description: "AI persona configuration (for AI players)",
+            },
+        },
+        required: ["sessionId", "id", "name", "role", "controlType"],
+    },
+    handler: async (args) => {
+        const input = CreatePlayerInput.parse(args);
+        const session = await sessionManager.getOrCreate(input.sessionId);
+        const players = ensurePlayersMap(session);
+        if (players[input.id]) {
+            throw new Error(`Player already exists: ${input.id}`);
+        }
+        const player = createPlayer(input.id, input.name, input.role, input.controlType);
+        // Link character if provided
+        if (input.characterId) {
+            if (!session.characters[input.characterId]) {
+                throw new Error(`Character not found: ${input.characterId}`);
+            }
+            player.characterId = input.characterId;
+        }
+        // Add AI persona if AI player
+        if (input.controlType === "ai") {
+            if (input.aiPersona) {
+                player.aiPersona = {
+                    playstyle: input.aiPersona.playstyle,
+                    talkativeness: input.aiPersona.talkativeness ?? 5,
+                    personalityNotes: input.aiPersona.personalityNotes,
+                };
+            }
+            else {
+                player.aiPersona = createDefaultAIPersona();
+            }
+        }
+        // Set GM player ID if this is the GM
+        if (input.role === "gm" && !session.gmPlayerId) {
+            session.gmPlayerId = input.id;
+        }
+        players[input.id] = player;
+        await sessionManager.save(session);
+        return {
+            message: `Player '${input.name}' created (${input.controlType}, ${input.role})`,
+            player: {
+                id: player.id,
+                name: player.name,
+                role: player.role,
+                controlType: player.controlType,
+                characterId: player.characterId,
+                status: player.status,
+            },
+        };
+    },
+};
+/**
+ * get_player tool
+ */
+export const getPlayerTool = {
+    name: "get_player",
+    description: "Get a player's full details",
+    inputSchema: {
+        type: "object",
+        properties: {
+            sessionId: { type: "string", description: "Session ID" },
+            playerId: { type: "string", description: "Player ID" },
+        },
+        required: ["sessionId", "playerId"],
+    },
+    handler: async (args) => {
+        const input = GetPlayerInput.parse(args);
+        const session = await sessionManager.get(input.sessionId);
+        if (!session) {
+            throw new Error(`Session not found: ${input.sessionId}`);
+        }
+        const players = session.players || {};
+        const player = players[input.playerId];
+        if (!player) {
+            throw new Error(`Player not found: ${input.playerId}`);
+        }
+        // Include linked character info if available
+        let character = null;
+        if (player.characterId && session.characters[player.characterId]) {
+            const c = session.characters[player.characterId];
+            character = {
+                id: c.id,
+                name: c.name,
+                hp: c.hp,
+                conditions: c.conditions.map((cond) => cond.name),
+            };
+        }
+        return {
+            ...player,
+            character,
+        };
+    },
+};
+/**
+ * list_players tool
+ */
+export const listPlayersTool = {
+    name: "list_players",
+    description: "List all players in a session",
+    inputSchema: {
+        type: "object",
+        properties: {
+            sessionId: { type: "string", description: "Session ID" },
+        },
+        required: ["sessionId"],
+    },
+    handler: async (args) => {
+        const input = ListPlayersInput.parse(args);
+        const session = await sessionManager.get(input.sessionId);
+        if (!session) {
+            throw new Error(`Session not found: ${input.sessionId}`);
+        }
+        const players = session.players || {};
+        const playerList = Object.values(players).map((p) => {
+            const character = p.characterId ? session.characters[p.characterId] : null;
+            return {
+                id: p.id,
+                name: p.name,
+                role: p.role,
+                controlType: p.controlType,
+                status: p.status,
+                characterId: p.characterId,
+                characterName: character?.name,
+            };
+        });
+        return {
+            sessionId: input.sessionId,
+            count: playerList.length,
+            gmPlayerId: session.gmPlayerId,
+            players: playerList,
+        };
+    },
+};
+/**
+ * update_player tool
+ */
+export const updatePlayerTool = {
+    name: "update_player",
+    description: "Update a player's status, name, or AI persona",
+    inputSchema: {
+        type: "object",
+        properties: {
+            sessionId: { type: "string", description: "Session ID" },
+            playerId: { type: "string", description: "Player ID" },
+            name: { type: "string", description: "New display name" },
+            status: {
+                type: "string",
+                enum: ["active", "inactive", "waiting_for_input"],
+                description: "New status",
+            },
+            characterId: {
+                type: "string",
+                nullable: true,
+                description: "New character ID (or null to unlink)",
+            },
+            aiPersona: {
+                type: "object",
+                properties: {
+                    playstyle: {
+                        type: "string",
+                        enum: ["tactical", "roleplay", "cautious", "reckless"],
+                    },
+                    talkativeness: { type: "number", minimum: 0, maximum: 10 },
+                    personalityNotes: { type: "string" },
+                },
+                description: "Update AI persona (for AI players)",
+            },
+        },
+        required: ["sessionId", "playerId"],
+    },
+    handler: async (args) => {
+        const input = UpdatePlayerInput.parse(args);
+        const session = await sessionManager.get(input.sessionId);
+        if (!session) {
+            throw new Error(`Session not found: ${input.sessionId}`);
+        }
+        const players = session.players || {};
+        const player = players[input.playerId];
+        if (!player) {
+            throw new Error(`Player not found: ${input.playerId}`);
+        }
+        const changes = [];
+        if (input.name !== undefined) {
+            player.name = input.name;
+            changes.push(`Name set to '${input.name}'`);
+        }
+        if (input.status !== undefined) {
+            player.status = input.status;
+            changes.push(`Status set to '${input.status}'`);
+        }
+        if (input.characterId !== undefined) {
+            if (input.characterId === null) {
+                delete player.characterId;
+                changes.push("Character unlinked");
+            }
+            else {
+                if (!session.characters[input.characterId]) {
+                    throw new Error(`Character not found: ${input.characterId}`);
+                }
+                player.characterId = input.characterId;
+                changes.push(`Linked to character '${input.characterId}'`);
+            }
+        }
+        if (input.aiPersona && player.controlType === "ai") {
+            if (!player.aiPersona) {
+                player.aiPersona = createDefaultAIPersona();
+            }
+            if (input.aiPersona.playstyle !== undefined) {
+                player.aiPersona.playstyle = input.aiPersona.playstyle;
+                changes.push(`AI playstyle set to '${input.aiPersona.playstyle}'`);
+            }
+            if (input.aiPersona.talkativeness !== undefined) {
+                player.aiPersona.talkativeness = input.aiPersona.talkativeness;
+                changes.push(`AI talkativeness set to ${input.aiPersona.talkativeness}`);
+            }
+            if (input.aiPersona.personalityNotes !== undefined) {
+                player.aiPersona.personalityNotes = input.aiPersona.personalityNotes;
+                changes.push("AI personality notes updated");
+            }
+        }
+        player.lastActiveAt = new Date().toISOString();
+        await sessionManager.save(session);
+        return {
+            player: player.name,
+            changes,
+            currentState: {
+                id: player.id,
+                name: player.name,
+                status: player.status,
+                characterId: player.characterId,
+                aiPersona: player.aiPersona,
+            },
+        };
+    },
+};
+/**
+ * delete_player tool
+ */
+export const deletePlayerTool = {
+    name: "delete_player",
+    description: "Remove a player from the session",
+    inputSchema: {
+        type: "object",
+        properties: {
+            sessionId: { type: "string", description: "Session ID" },
+            playerId: { type: "string", description: "Player ID to delete" },
+        },
+        required: ["sessionId", "playerId"],
+    },
+    handler: async (args) => {
+        const input = DeletePlayerInput.parse(args);
+        const session = await sessionManager.get(input.sessionId);
+        if (!session) {
+            throw new Error(`Session not found: ${input.sessionId}`);
+        }
+        const players = session.players || {};
+        const player = players[input.playerId];
+        if (!player) {
+            throw new Error(`Player not found: ${input.playerId}`);
+        }
+        delete players[input.playerId];
+        // Update GM if we deleted the GM
+        if (session.gmPlayerId === input.playerId) {
+            session.gmPlayerId = undefined;
+        }
+        // Remove from turn order if in turns
+        if (session.turns && session.turns.turnOrder.includes(input.playerId)) {
+            session.turns.turnOrder = session.turns.turnOrder.filter((id) => id !== input.playerId);
+            if (session.turns.currentPlayerId === input.playerId) {
+                // Move to next player
+                if (session.turns.turnOrder.length > 0) {
+                    session.turns.turnIndex = session.turns.turnIndex % session.turns.turnOrder.length;
+                    session.turns.currentPlayerId = session.turns.turnOrder[session.turns.turnIndex];
+                }
+                else {
+                    session.turns.currentPlayerId = null;
+                }
+            }
+        }
+        await sessionManager.save(session);
+        return {
+            message: `Player '${player.name}' deleted`,
+            playerId: input.playerId,
+        };
+    },
+};
+/**
+ * assign_character tool
+ */
+export const assignCharacterTool = {
+    name: "assign_character",
+    description: "Link a player to a character",
+    inputSchema: {
+        type: "object",
+        properties: {
+            sessionId: { type: "string", description: "Session ID" },
+            playerId: { type: "string", description: "Player ID" },
+            characterId: { type: "string", description: "Character ID to assign" },
+        },
+        required: ["sessionId", "playerId", "characterId"],
+    },
+    handler: async (args) => {
+        const input = AssignCharacterInput.parse(args);
+        const session = await sessionManager.get(input.sessionId);
+        if (!session) {
+            throw new Error(`Session not found: ${input.sessionId}`);
+        }
+        const players = session.players || {};
+        const player = players[input.playerId];
+        if (!player) {
+            throw new Error(`Player not found: ${input.playerId}`);
+        }
+        const character = session.characters[input.characterId];
+        if (!character) {
+            throw new Error(`Character not found: ${input.characterId}`);
+        }
+        player.characterId = input.characterId;
+        player.lastActiveAt = new Date().toISOString();
+        await sessionManager.save(session);
+        return {
+            message: `Player '${player.name}' now controls character '${character.name}'`,
+            player: {
+                id: player.id,
+                name: player.name,
+            },
+            character: {
+                id: character.id,
+                name: character.name,
+            },
+        };
+    },
+};
+export const playerTools = [
+    createPlayerTool,
+    getPlayerTool,
+    listPlayersTool,
+    updatePlayerTool,
+    deletePlayerTool,
+    assignCharacterTool,
+];
+//# sourceMappingURL=players.js.map

package/dist/tools/players.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"players.js","sourceRoot":"","sources":["../../src/tools/players.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,gBAAgB;AAChB,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;IACvC,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACpC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,SAAS,EAAE,CAAC;SACT,MAAM,CAAC;QACN,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;QACnE,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;QAC9D,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KACxC,CAAC;SACD,QAAQ,EAAE;CACd,CAAC,CAAC;AAEH,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;CACrB,CAAC,CAAC;AAEH,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;CACtB,CAAC,CAAC;AAEH,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,UAAU,EAAE,mBAAmB,CAAC,CAAC,CAAC,QAAQ,EAAE;IACtE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC7C,SAAS,EAAE,CAAC;SACT,MAAM,CAAC;QACN,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,QAAQ,EAAE;QAC9E,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;QACnD,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KACxC,CAAC;SACD,QAAQ,EAAE;CACd,CAAC,CAAC;AAEH,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;CACrB,CAAC,CAAC;AAEH,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;CACxB,CAAC,CAAC;AAEH;;GAEG;AACH,SAAS,gBAAgB,CAAC,OAA6C;IACrE,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACrB,OAAO,CAAC,OAAO,GAAG,EAAE,CAAC;IACvB,CAAC;IACD,OAAO,OAAO,CAAC,OAAO,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAiB;IAC5C,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE,2CAA2C;IACxD,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE;YACxD,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kBAAkB,EAAE;YACvD,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE;YACrD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,WAAW,CAAC;gBAC/B,WAAW,EAAE,oCAAoC;aAClD;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,OAAO,EAAE,IAAI,CAAC;gBACrB,WAAW,EAAE,wBAAwB;aACtC;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,iCAAiC;aAC/C;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,SAAS,EAAE;wBACT,IAAI,EAAE,QAAQ;wBACd,IAAI,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,CAAC;wBACtD,WAAW,EAAE,cAAc;qBAC5B;oBACD,aAAa,EAAE;wBACb,IAAI,EAAE,QAAQ;wBACd,OAAO,EAAE,CAAC;wBACV,OAAO,EAAE,EAAE;wBACX,WAAW,EAAE,2CAA2C;qBACzD;oBACD,gBAAgB,EAAE;wBAChB,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,yCAAyC;qBACvD;iBACF;gBACD,WAAW,EAAE,2CAA2C;aACzD;SACF;QACD,QAAQ,EAAE,CAAC,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,CAAC;KAC7D;IACD,OAAO,EAAE,KAAK,EAAE,IAAa,EAAE,EAAE;QAC/B,MAAM,KAAK,GAAG,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAE5C,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,WAAW,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAClE,MAAM,OAAO,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAE1C,IAAI,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,0BAA0B,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;QACxD,CAAC;QAED,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;QAEjF,6BAA6B;QAC7B,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;YACtB,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC3C,MAAM,IAAI,KAAK,CAAC,wBAAwB,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;YAC/D,CAAC;YACD,MAAM,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;QACzC,CAAC;QAED,8BAA8B;QAC9B,IAAI,KAAK,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;YAC/B,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;gBACpB,MAAM,CAAC,SAAS,GAAG;oBACjB,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,SAAS;oBACpC,aAAa,EAAE,KAAK,CAAC,SAAS,CAAC,aAAa,IAAI,CAAC;oBACjD,gBAAgB,EAAE,KAAK,CAAC,SAAS,CAAC,gBAAgB;iBACnD,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,SAAS,GAAG,sBAAsB,EAAE,CAAC;YAC9C,CAAC;QACH,CAAC;QAED,qCAAqC;QACrC,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;YAC/C,OAAO,CAAC,UAAU,GAAG,KAAK,CAAC,EAAE,CAAC;QAChC,CAAC;QAED,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC;QAC3B,MAAM,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAEnC,OAAO;YACL,OAAO,EAAE,WAAW,KAAK,CAAC,IAAI,cAAc,KAAK,CAAC,WAAW,KAAK,KAAK,CAAC,IAAI,GAAG;YAC/E,MAAM,EAAE;gBACN,EAAE,EAAE,MAAM,CAAC,EAAE;gBACb,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,MAAM,EAAE,MAAM,CAAC,MAAM;aACtB;SACF,CAAC;IACJ,CAAC;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAiB;IACzC,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,6BAA6B;IAC1C,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE;YACxD,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE;SACvD;QACD,QAAQ,EAAE,CAAC,WAAW,EAAE,UAAU,CAAC;KACpC;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,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;QACtC,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACvC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,qBAAqB,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;QACzD,CAAC;QAED,6CAA6C;QAC7C,IAAI,SAAS,GAAG,IAAI,CAAC;QACrB,IAAI,MAAM,CAAC,WAAW,IAAI,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;YACjE,MAAM,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;YACjD,SAAS,GAAG;gBACV,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,UAAU,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;aAClD,CAAC;QACJ,CAAC;QAED,OAAO;YACL,GAAG,MAAM;YACT,SAAS;SACV,CAAC;IACJ,CAAC;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAiB;IAC3C,IAAI,EAAE,cAAc;IACpB,WAAW,EAAE,+BAA+B;IAC5C,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE;SACzD;QACD,QAAQ,EAAE,CAAC,WAAW,CAAC;KACxB;IACD,OAAO,EAAE,KAAK,EAAE,IAAa,EAAE,EAAE;QAC/B,MAAM,KAAK,GAAG,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAE3C,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,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;QACtC,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YAClD,MAAM,SAAS,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YAC3E,OAAO;gBACL,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,WAAW,EAAE,CAAC,CAAC,WAAW;gBAC1B,MAAM,EAAE,CAAC,CAAC,MAAM;gBAChB,WAAW,EAAE,CAAC,CAAC,WAAW;gBAC1B,aAAa,EAAE,SAAS,EAAE,IAAI;aAC/B,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,OAAO;YACL,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,KAAK,EAAE,UAAU,CAAC,MAAM;YACxB,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,OAAO,EAAE,UAAU;SACpB,CAAC;IACJ,CAAC;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAiB;IAC5C,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE,+CAA+C;IAC5D,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE;YACxD,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE;YACtD,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kBAAkB,EAAE;YACzD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,QAAQ,EAAE,UAAU,EAAE,mBAAmB,CAAC;gBACjD,WAAW,EAAE,YAAY;aAC1B;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,sCAAsC;aACpD;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,SAAS,EAAE;wBACT,IAAI,EAAE,QAAQ;wBACd,IAAI,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,CAAC;qBACvD;oBACD,aAAa,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE;oBAC1D,gBAAgB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;iBACrC;gBACD,WAAW,EAAE,oCAAoC;aAClD;SACF;QACD,QAAQ,EAAE,CAAC,WAAW,EAAE,UAAU,CAAC;KACpC;IACD,OAAO,EAAE,KAAK,EAAE,IAAa,EAAE,EAAE;QAC/B,MAAM,KAAK,GAAG,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAE5C,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,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;QACtC,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACvC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,qBAAqB,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;QACzD,CAAC;QAED,MAAM,OAAO,GAAa,EAAE,CAAC;QAE7B,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC7B,MAAM,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;YACzB,OAAO,CAAC,IAAI,CAAC,gBAAgB,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC;QAC9C,CAAC;QAED,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC/B,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;YAC7B,OAAO,CAAC,IAAI,CAAC,kBAAkB,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;QAClD,CAAC;QAED,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;YACpC,IAAI,KAAK,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;gBAC/B,OAAO,MAAM,CAAC,WAAW,CAAC;gBAC1B,OAAO,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;YACrC,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC;oBAC3C,MAAM,IAAI,KAAK,CAAC,wBAAwB,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;gBAC/D,CAAC;gBACD,MAAM,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;gBACvC,OAAO,CAAC,IAAI,CAAC,wBAAwB,KAAK,CAAC,WAAW,GAAG,CAAC,CAAC;YAC7D,CAAC;QACH,CAAC;QAED,IAAI,KAAK,CAAC,SAAS,IAAI,MAAM,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;YACnD,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;gBACtB,MAAM,CAAC,SAAS,GAAG,sBAAsB,EAAE,CAAC;YAC9C,CAAC;YACD,IAAI,KAAK,CAAC,SAAS,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;gBAC5C,MAAM,CAAC,SAAS,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC,SAAS,CAAC;gBACvD,OAAO,CAAC,IAAI,CAAC,wBAAwB,KAAK,CAAC,SAAS,CAAC,SAAS,GAAG,CAAC,CAAC;YACrE,CAAC;YACD,IAAI,KAAK,CAAC,SAAS,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;gBAChD,MAAM,CAAC,SAAS,CAAC,aAAa,GAAG,KAAK,CAAC,SAAS,CAAC,aAAa,CAAC;gBAC/D,OAAO,CAAC,IAAI,CAAC,2BAA2B,KAAK,CAAC,SAAS,CAAC,aAAa,EAAE,CAAC,CAAC;YAC3E,CAAC;YACD,IAAI,KAAK,CAAC,SAAS,CAAC,gBAAgB,KAAK,SAAS,EAAE,CAAC;gBACnD,MAAM,CAAC,SAAS,CAAC,gBAAgB,GAAG,KAAK,CAAC,SAAS,CAAC,gBAAgB,CAAC;gBACrE,OAAO,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;YAC/C,CAAC;QACH,CAAC;QAED,MAAM,CAAC,YAAY,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC/C,MAAM,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAEnC,OAAO;YACL,MAAM,EAAE,MAAM,CAAC,IAAI;YACnB,OAAO;YACP,YAAY,EAAE;gBACZ,EAAE,EAAE,MAAM,CAAC,EAAE;gBACb,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,SAAS,EAAE,MAAM,CAAC,SAAS;aAC5B;SACF,CAAC;IACJ,CAAC;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAiB;IAC5C,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE,kCAAkC;IAC/C,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE;YACxD,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qBAAqB,EAAE;SACjE;QACD,QAAQ,EAAE,CAAC,WAAW,EAAE,UAAU,CAAC;KACpC;IACD,OAAO,EAAE,KAAK,EAAE,IAAa,EAAE,EAAE;QAC/B,MAAM,KAAK,GAAG,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAE5C,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,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;QACtC,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACvC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,qBAAqB,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;QACzD,CAAC;QAED,OAAO,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAE/B,iCAAiC;QACjC,IAAI,OAAO,CAAC,UAAU,KAAK,KAAK,CAAC,QAAQ,EAAE,CAAC;YAC1C,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;QACjC,CAAC;QAED,qCAAqC;QACrC,IAAI,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;YACtE,OAAO,CAAC,KAAK,CAAC,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,KAAK,CAAC,QAAQ,CAAC,CAAC;YACxF,IAAI,OAAO,CAAC,KAAK,CAAC,eAAe,KAAK,KAAK,CAAC,QAAQ,EAAE,CAAC;gBACrD,sBAAsB;gBACtB,IAAI,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACvC,OAAO,CAAC,KAAK,CAAC,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC;oBACnF,OAAO,CAAC,KAAK,CAAC,eAAe,GAAG,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;gBACnF,CAAC;qBAAM,CAAC;oBACN,OAAO,CAAC,KAAK,CAAC,eAAe,GAAG,IAAI,CAAC;gBACvC,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAEnC,OAAO;YACL,OAAO,EAAE,WAAW,MAAM,CAAC,IAAI,WAAW;YAC1C,QAAQ,EAAE,KAAK,CAAC,QAAQ;SACzB,CAAC;IACJ,CAAC;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAiB;IAC/C,IAAI,EAAE,kBAAkB;IACxB,WAAW,EAAE,8BAA8B;IAC3C,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE;YACxD,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE;YACtD,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wBAAwB,EAAE;SACvE;QACD,QAAQ,EAAE,CAAC,WAAW,EAAE,UAAU,EAAE,aAAa,CAAC;KACnD;IACD,OAAO,EAAE,KAAK,EAAE,IAAa,EAAE,EAAE;QAC/B,MAAM,KAAK,GAAG,oBAAoB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAE/C,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,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;QACtC,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACvC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,qBAAqB,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;QACzD,CAAC;QAED,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QACxD,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,wBAAwB,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;QAC/D,CAAC;QAED,MAAM,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;QACvC,MAAM,CAAC,YAAY,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC/C,MAAM,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAEnC,OAAO;YACL,OAAO,EAAE,WAAW,MAAM,CAAC,IAAI,6BAA6B,SAAS,CAAC,IAAI,GAAG;YAC7E,MAAM,EAAE;gBACN,EAAE,EAAE,MAAM,CAAC,EAAE;gBACb,IAAI,EAAE,MAAM,CAAC,IAAI;aAClB;YACD,SAAS,EAAE;gBACT,EAAE,EAAE,SAAS,CAAC,EAAE;gBAChB,IAAI,EAAE,SAAS,CAAC,IAAI;aACrB;SACF,CAAC;IACJ,CAAC;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,gBAAgB;IAChB,aAAa;IACb,eAAe;IACf,gBAAgB;IAChB,gBAAgB;IAChB,mBAAmB;CACpB,CAAC"}

package/dist/tools/portable-clues.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Portable Clues System
+ *
+ * Flexible revelations that can be delivered anywhere.
+ * Based on the Lazy DM pattern of "secrets and clues" abstracted from discovery.
+ */
+import type { MCPToolEntry } from "@mythxengine/types";
+/**
+ * create_portable_clue tool
+ */
+export declare const createPortableClueTool: MCPToolEntry;
+/**
+ * get_unrevealed_clues tool
+ */
+export declare const getUnrevealedCluesTool: MCPToolEntry;
+/**
+ * reveal_clue tool
+ */
+export declare const revealClueTool: MCPToolEntry;
+/**
+ * suggest_clue_delivery tool
+ */
+export declare const suggestClueDeliveryTool: MCPToolEntry;
+/**
+ * import_leads_as_clues tool
+ */
+export declare const importLeadsAsCluesTool: MCPToolEntry;
+export declare const portableClueTools: MCPToolEntry[];
+//# sourceMappingURL=portable-clues.d.ts.map

package/dist/tools/portable-clues.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"portable-clues.d.ts","sourceRoot":"","sources":["../../src/tools/portable-clues.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAY,MAAM,oBAAoB,CAAC;AAwJjE;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,YAsFpC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,YA6EpC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,YAsE5B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,YA+FrC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,YAoGpC,CAAC;AAEF,eAAO,MAAM,iBAAiB,gBAM7B,CAAC"}