foundryvtt-mcp 0.11.0

package/dist/tools/definitions.js

@@ -0,0 +1,429 @@
+/**
+ * @fileoverview Tool definitions for FoundryVTT MCP Server
+ *
+ * This module contains all tool schema definitions organized by category.
+ * Tools are separated into logical groups for better maintainability.
+ */
+/**
+ * Dice rolling tool definitions
+ */
+export const diceTools = [
+    {
+        name: 'roll_dice',
+        description: 'Roll dice using standard RPG notation (e.g., 1d20, 3d6+4)',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                formula: {
+                    type: 'string',
+                    description: 'Dice formula (e.g., "1d20+5", "3d6")',
+                },
+                reason: {
+                    type: 'string',
+                    description: 'Optional reason for the roll',
+                },
+            },
+            required: ['formula'],
+        },
+    },
+];
+/**
+ * Actor management tool definitions
+ */
+export const actorTools = [
+    {
+        name: 'search_actors',
+        description: 'Search for actors (characters, NPCs) in FoundryVTT',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                query: {
+                    type: 'string',
+                    description: 'Search query for actor names',
+                },
+                type: {
+                    type: 'string',
+                    description: 'Actor type filter (character, npc, etc.)',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Maximum number of results to return',
+                    default: 10,
+                },
+            },
+        },
+    },
+    {
+        name: 'get_actor_details',
+        description: 'Get detailed information about a specific actor',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                actorId: {
+                    type: 'string',
+                    description: 'The ID of the actor to retrieve',
+                },
+            },
+            required: ['actorId'],
+        },
+    },
+];
+/**
+ * Item management tool definitions
+ */
+export const itemTools = [
+    {
+        name: 'search_items',
+        description: 'Search for items in FoundryVTT',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                query: {
+                    type: 'string',
+                    description: 'Search query for item names',
+                },
+                type: {
+                    type: 'string',
+                    description: 'Item type filter (weapon, armor, consumable, etc.)',
+                },
+                rarity: {
+                    type: 'string',
+                    description: 'Item rarity filter (common, uncommon, rare, etc.)',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Maximum number of results to return',
+                    default: 10,
+                },
+            },
+        },
+    },
+];
+/**
+ * Scene management tool definitions
+ */
+export const sceneTools = [
+    {
+        name: 'get_scene_info',
+        description: 'Get information about the current or specified scene',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                sceneId: {
+                    type: 'string',
+                    description: 'Optional scene ID. If not provided, returns current scene',
+                },
+            },
+        },
+    },
+];
+/**
+ * Content generation tool definitions
+ */
+export const generationTools = [
+    {
+        name: 'generate_npc',
+        description: 'Generate a random NPC with stats and background',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                level: {
+                    type: 'number',
+                    description: 'Character level (1-20)',
+                    minimum: 1,
+                    maximum: 20,
+                    default: 1,
+                },
+                race: {
+                    type: 'string',
+                    description: 'Character race (optional)',
+                },
+                class: {
+                    type: 'string',
+                    description: 'Character class (optional)',
+                },
+            },
+        },
+    },
+    {
+        name: 'generate_loot',
+        description: 'Generate random loot for encounters',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                challengeRating: {
+                    type: 'number',
+                    description: 'Challenge rating for loot generation',
+                    minimum: 0,
+                    maximum: 30,
+                },
+                treasureType: {
+                    type: 'string',
+                    description: 'Type of treasure (hoard, individual, etc.)',
+                },
+            },
+        },
+    },
+    {
+        name: 'lookup_rule',
+        description: 'Look up game rules and mechanics',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                query: {
+                    type: 'string',
+                    description: 'Rule or mechanic to look up',
+                },
+                system: {
+                    type: 'string',
+                    description: 'Game system (D&D 5e, Pathfinder, etc.)',
+                },
+            },
+            required: ['query'],
+        },
+    },
+];
+/**
+ * Diagnostics and logging tool definitions
+ */
+export const diagnosticsTools = [
+    {
+        name: 'get_recent_logs',
+        description: 'Get recent log entries from FoundryVTT',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                limit: {
+                    type: 'number',
+                    description: 'Number of log entries to retrieve',
+                    default: 20,
+                    minimum: 1,
+                    maximum: 100,
+                },
+                level: {
+                    type: 'string',
+                    description: 'Log level filter (debug, info, warn, error)',
+                    enum: ['debug', 'info', 'warn', 'error'],
+                },
+                since: {
+                    type: 'string',
+                    description: 'Get logs since this timestamp (ISO format)',
+                },
+            },
+        },
+    },
+    {
+        name: 'search_logs',
+        description: 'Search through FoundryVTT logs',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                query: {
+                    type: 'string',
+                    description: 'Search query for log contents',
+                },
+                level: {
+                    type: 'string',
+                    description: 'Log level filter',
+                    enum: ['debug', 'info', 'warn', 'error'],
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Maximum number of results',
+                    default: 50,
+                },
+            },
+            required: ['query'],
+        },
+    },
+    {
+        name: 'get_system_health',
+        description: 'Get system health and performance metrics',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+    },
+    {
+        name: 'diagnose_errors',
+        description: 'Diagnose and analyze system errors',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                category: {
+                    type: 'string',
+                    description: 'Error category to focus on',
+                },
+            },
+        },
+    },
+    {
+        name: 'get_health_status',
+        description: 'Get comprehensive health status of FoundryVTT server',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+    },
+];
+/**
+ * Combat tool definitions
+ */
+export const combatTools = [
+    {
+        name: 'get_combat_state',
+        description: 'Get the current active combat state including initiative order, HP, and AC',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+    },
+];
+/**
+ * Chat message tool definitions
+ */
+export const chatTools = [
+    {
+        name: 'get_chat_messages',
+        description: 'Get recent chat messages from the game',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                limit: {
+                    type: 'number',
+                    description: 'Number of messages to retrieve (default 20)',
+                    default: 20,
+                    minimum: 1,
+                    maximum: 100,
+                },
+            },
+        },
+    },
+];
+/**
+ * User tool definitions
+ */
+export const userTools = [
+    {
+        name: 'get_users',
+        description: 'Get the list of users with their online status and roles',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+    },
+];
+/**
+ * Journal tool definitions
+ */
+export const journalTools = [
+    {
+        name: 'search_journals',
+        description: 'Search journal entries by name or content',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                query: {
+                    type: 'string',
+                    description: 'Search query for journal names and content',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Maximum number of results',
+                    default: 10,
+                },
+            },
+            required: ['query'],
+        },
+    },
+    {
+        name: 'get_journal',
+        description: 'Get a specific journal entry with its pages',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                journalId: {
+                    type: 'string',
+                    description: 'The ID of the journal entry to retrieve',
+                },
+            },
+            required: ['journalId'],
+        },
+    },
+];
+/**
+ * World-level tool definitions
+ */
+export const worldTools = [
+    {
+        name: 'search_world',
+        description: 'Search across all collections (actors, items, scenes, journals) by name',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                query: {
+                    type: 'string',
+                    description: 'Search query to match against entity names',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Maximum results per collection (default 5)',
+                    default: 5,
+                },
+            },
+            required: ['query'],
+        },
+    },
+    {
+        name: 'get_world_summary',
+        description: 'Get world metadata and collection counts',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+    },
+    {
+        name: 'refresh_world_data',
+        description: 'Force re-fetch of world data from the FoundryVTT server',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+    },
+];
+/**
+ * Get all tool definitions combined
+ */
+export function getAllTools() {
+    return [
+        ...diceTools,
+        ...actorTools,
+        ...itemTools,
+        ...sceneTools,
+        ...combatTools,
+        ...chatTools,
+        ...userTools,
+        ...journalTools,
+        ...worldTools,
+        ...generationTools,
+        ...diagnosticsTools,
+    ];
+}
+/**
+ * Get modernized tool definitions from registry (when available)
+ */
+export async function getModernizedTools() {
+    try {
+        const { toolRegistry } = await import('./registry.js');
+        const modernTools = toolRegistry.getToolDefinitions();
+        // Filter out tools that have been modernized to avoid duplicates
+        const modernToolNames = new Set(modernTools.map((tool) => tool.name));
+        const legacyTools = getAllTools().filter((tool) => !modernToolNames.has(tool.name));
+        return [...modernTools, ...legacyTools];
+    }
+    catch (_error) {
+        // Fallback to legacy definitions if registry is not available
+        return getAllTools();
+    }
+}
+//# sourceMappingURL=definitions.js.map

package/dist/tools/definitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/tools/definitions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB;QACE,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE,2DAA2D;QACxE,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,sCAAsC;iBACpD;gBACD,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,8BAA8B;iBAC5C;aACF;YACD,QAAQ,EAAE,CAAC,SAAS,CAAC;SACtB;KACF;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB;QACE,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,oDAAoD;QACjE,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,8BAA8B;iBAC5C;gBACD,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,0CAA0C;iBACxD;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,qCAAqC;oBAClD,OAAO,EAAE,EAAE;iBACZ;aACF;SACF;KACF;IACD;QACE,IAAI,EAAE,mBAAmB;QACzB,WAAW,EAAE,iDAAiD;QAC9D,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,iCAAiC;iBAC/C;aACF;YACD,QAAQ,EAAE,CAAC,SAAS,CAAC;SACtB;KACF;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB;QACE,IAAI,EAAE,cAAc;QACpB,WAAW,EAAE,gCAAgC;QAC7C,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,6BAA6B;iBAC3C;gBACD,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,oDAAoD;iBAClE;gBACD,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,mDAAmD;iBACjE;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,qCAAqC;oBAClD,OAAO,EAAE,EAAE;iBACZ;aACF;SACF;KACF;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB;QACE,IAAI,EAAE,gBAAgB;QACtB,WAAW,EAAE,sDAAsD;QACnE,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,2DAA2D;iBACzE;aACF;SACF;KACF;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B;QACE,IAAI,EAAE,cAAc;QACpB,WAAW,EAAE,iDAAiD;QAC9D,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,wBAAwB;oBACrC,OAAO,EAAE,CAAC;oBACV,OAAO,EAAE,EAAE;oBACX,OAAO,EAAE,CAAC;iBACX;gBACD,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,2BAA2B;iBACzC;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,4BAA4B;iBAC1C;aACF;SACF;KACF;IACD;QACE,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,qCAAqC;QAClD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,eAAe,EAAE;oBACf,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,sCAAsC;oBACnD,OAAO,EAAE,CAAC;oBACV,OAAO,EAAE,EAAE;iBACZ;gBACD,YAAY,EAAE;oBACZ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,4CAA4C;iBAC1D;aACF;SACF;KACF;IACD;QACE,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,kCAAkC;QAC/C,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,6BAA6B;iBAC3C;gBACD,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,wCAAwC;iBACtD;aACF;YACD,QAAQ,EAAE,CAAC,OAAO,CAAC;SACpB;KACF;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B;QACE,IAAI,EAAE,iBAAiB;QACvB,WAAW,EAAE,wCAAwC;QACrD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,mCAAmC;oBAChD,OAAO,EAAE,EAAE;oBACX,OAAO,EAAE,CAAC;oBACV,OAAO,EAAE,GAAG;iBACb;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,6CAA6C;oBAC1D,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC;iBACzC;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,4CAA4C;iBAC1D;aACF;SACF;KACF;IACD;QACE,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,gCAAgC;QAC7C,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,+BAA+B;iBAC7C;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,kBAAkB;oBAC/B,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC;iBACzC;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,2BAA2B;oBACxC,OAAO,EAAE,EAAE;iBACZ;aACF;YACD,QAAQ,EAAE,CAAC,OAAO,CAAC;SACpB;KACF;IACD;QACE,IAAI,EAAE,mBAAmB;QACzB,WAAW,EAAE,2CAA2C;QACxD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE;SACf;KACF;IACD;QACE,IAAI,EAAE,iBAAiB;QACvB,WAAW,EAAE,oCAAoC;QACjD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,4BAA4B;iBAC1C;aACF;SACF;KACF;IACD;QACE,IAAI,EAAE,mBAAmB;QACzB,WAAW,EAAE,sDAAsD;QACnE,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE;SACf;KACF;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB;QACE,IAAI,EAAE,kBAAkB;QACxB,WAAW,EAAE,4EAA4E;QACzF,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE;SACf;KACF;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB;QACE,IAAI,EAAE,mBAAmB;QACzB,WAAW,EAAE,wCAAwC;QACrD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,6CAA6C;oBAC1D,OAAO,EAAE,EAAE;oBACX,OAAO,EAAE,CAAC;oBACV,OAAO,EAAE,GAAG;iBACb;aACF;SACF;KACF;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB;QACE,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE,0DAA0D;QACvE,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE;SACf;KACF;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B;QACE,IAAI,EAAE,iBAAiB;QACvB,WAAW,EAAE,2CAA2C;QACxD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,4CAA4C;iBAC1D;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,2BAA2B;oBACxC,OAAO,EAAE,EAAE;iBACZ;aACF;YACD,QAAQ,EAAE,CAAC,OAAO,CAAC;SACpB;KACF;IACD;QACE,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,6CAA6C;QAC1D,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,SAAS,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,yCAAyC;iBACvD;aACF;YACD,QAAQ,EAAE,CAAC,WAAW,CAAC;SACxB;KACF;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB;QACE,IAAI,EAAE,cAAc;QACpB,WAAW,EAAE,yEAAyE;QACtF,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,4CAA4C;iBAC1D;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,4CAA4C;oBACzD,OAAO,EAAE,CAAC;iBACX;aACF;YACD,QAAQ,EAAE,CAAC,OAAO,CAAC;SACpB;KACF;IACD;QACE,IAAI,EAAE,mBAAmB;QACzB,WAAW,EAAE,0CAA0C;QACvD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE;SACf;KACF;IACD;QACE,IAAI,EAAE,oBAAoB;QAC1B,WAAW,EAAE,yDAAyD;QACtE,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE;SACf;KACF;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,WAAW;IACzB,OAAO;QACL,GAAG,SAAS;QACZ,GAAG,UAAU;QACb,GAAG,SAAS;QACZ,GAAG,UAAU;QACb,GAAG,WAAW;QACd,GAAG,SAAS;QACZ,GAAG,SAAS;QACZ,GAAG,YAAY;QACf,GAAG,UAAU;QACb,GAAG,eAAe;QAClB,GAAG,gBAAgB;KACpB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,IAAI,CAAC;QACH,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;QACvD,MAAM,WAAW,GAAG,YAAY,CAAC,kBAAkB,EAAE,CAAC;QAEtD,iEAAiE;QACjE,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QACtE,MAAM,WAAW,GAAG,WAAW,EAAE,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAEpF,OAAO,CAAC,GAAG,WAAW,EAAE,GAAG,WAAW,CAAC,CAAC;IAC1C,CAAC;IAAC,OAAO,MAAM,EAAE,CAAC;QAChB,8DAA8D;QAC9D,OAAO,WAAW,EAAE,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/tools/handlers/actors.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @fileoverview Actor management tool handlers
+ *
+ * Handles searching for actors and retrieving detailed actor information.
+ */
+import type { FoundryClient } from '../../foundry/client.js';
+/**
+ * Handles actor search requests
+ */
+export declare function handleSearchActors(args: {
+    query?: string;
+    type?: string;
+    limit?: number;
+}, foundryClient: FoundryClient): Promise<{
+    content: {
+        type: string;
+        text: string;
+    }[];
+}>;
+/**
+ * Handles detailed actor information requests
+ */
+export declare function handleGetActorDetails(args: {
+    actorId: string;
+}, foundryClient: FoundryClient): Promise<{
+    content: {
+        type: string;
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=actors.d.ts.map

package/dist/tools/handlers/actors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actors.d.ts","sourceRoot":"","sources":["../../../src/tools/handlers/actors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAG7D;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE;IACJ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,EACD,aAAa,EAAE,aAAa;;;;;GAqC7B;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,IAAI,EAAE;IACJ,OAAO,EAAE,MAAM,CAAC;CACjB,EACD,aAAa,EAAE,aAAa;;;;;GAsC7B"}

package/dist/tools/handlers/actors.js

@@ -0,0 +1,76 @@
+/**
+ * @fileoverview Actor management tool handlers
+ *
+ * Handles searching for actors and retrieving detailed actor information.
+ */
+import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
+import { withToolError } from './utils.js';
+/**
+ * Handles actor search requests
+ */
+export async function handleSearchActors(args, foundryClient) {
+    const { query, type, limit = 10 } = args;
+    return withToolError('search actors', async () => {
+        const searchParams = {
+            query: query || '',
+            limit,
+        };
+        if (type) {
+            searchParams.type = type;
+        }
+        const result = await foundryClient.searchActors(searchParams);
+        const actorList = result.actors
+            .map((actor) => `- **${actor.name}** (${actor.type}) - Level ${actor.level || 'Unknown'} - HP: ${actor.hp?.value || 'Unknown'}/${actor.hp?.max || 'Unknown'}`)
+            .join('\n');
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `🎭 **Actor Search Results**
+**Query:** ${query || 'All actors'}
+**Type Filter:** ${type || 'All types'}
+**Results:** ${result.actors.length}/${result.total} total
+
+${actorList || 'No actors found matching the criteria.'}
+
+**Page:** ${result.page} | **Limit:** ${result.limit}`,
+                },
+            ],
+        };
+    });
+}
+/**
+ * Handles detailed actor information requests
+ */
+export async function handleGetActorDetails(args, foundryClient) {
+    const { actorId } = args;
+    if (!actorId || typeof actorId !== 'string') {
+        throw new McpError(ErrorCode.InvalidParams, 'Actor ID is required and must be a string');
+    }
+    return withToolError('get actor details', async () => {
+        const actor = await foundryClient.getActor(actorId);
+        const abilities = actor.abilities
+            ? Object.entries(actor.abilities)
+                .map(([key, ability]) => `**${key.toUpperCase()}:** ${ability.value} (${ability.mod >= 0 ? '+' : ''}${ability.mod})`)
+                .join('\n')
+            : 'No ability scores available';
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `🎭 **Actor Details: ${actor.name}**
+**Type:** ${actor.type}
+**Level:** ${actor.level || 'Unknown'}
+**Hit Points:** ${actor.hp?.value || 'Unknown'}/${actor.hp?.max || 'Unknown'}
+**Armor Class:** ${actor.ac?.value || 'Unknown'}
+
+**Ability Scores:**
+${abilities}
+
+**Description:** ${actor.description || 'No description available.'}`,
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=actors.js.map

package/dist/tools/handlers/actors.js.map

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

package/dist/tools/handlers/chat.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Chat message tool handler
+ */
+import type { FoundryClient } from '../../foundry/client.js';
+export declare function handleGetChatMessages(args: {
+    limit?: number;
+}, foundryClient: FoundryClient): Promise<{
+    content: {
+        type: string;
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=chat.d.ts.map

package/dist/tools/handlers/chat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../../src/tools/handlers/chat.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAG7D,wBAAsB,qBAAqB,CACzC,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,EACxB,aAAa,EAAE,aAAa;;;;;GAqC7B"}

package/dist/tools/handlers/chat.js

@@ -0,0 +1,38 @@
+/**
+ * Chat message tool handler
+ */
+import { withToolError } from './utils.js';
+export async function handleGetChatMessages(args, foundryClient) {
+    return withToolError('get chat messages', async () => {
+        const limit = args.limit || 20;
+        const messages = foundryClient.getChatMessages(limit);
+        if (messages.length === 0) {
+            return {
+                content: [{ type: 'text', text: 'No chat messages found.' }],
+            };
+        }
+        // Resolve user names from worldData
+        const { users } = foundryClient.getUsers();
+        const userMap = new Map(users.map((u) => [u._id, u.name]));
+        const formatted = messages
+            .map((m) => {
+            const speaker = m.speaker?.alias || userMap.get(m.user) || 'Unknown';
+            const time = new Date(m.timestamp).toLocaleTimeString();
+            const content = m.content
+                .replace(/<[^>]+>/g, '')
+                .trim()
+                .slice(0, 200);
+            return `[${time}] **${speaker}**: ${content}`;
+        })
+            .join('\n');
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `**Recent Chat Messages** (${messages.length})\n\n${formatted}`,
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=chat.js.map

package/dist/tools/handlers/chat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.js","sourceRoot":"","sources":["../../../src/tools/handlers/chat.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,IAAwB,EACxB,aAA4B;IAE5B,OAAO,aAAa,CAAC,mBAAmB,EAAE,KAAK,IAAI,EAAE;QACnD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;QAC/B,MAAM,QAAQ,GAAG,aAAa,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;QAEtD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,yBAAyB,EAAE,CAAC;aAC7D,CAAC;QACJ,CAAC;QAED,oCAAoC;QACpC,MAAM,EAAE,KAAK,EAAE,GAAG,aAAa,CAAC,QAAQ,EAAE,CAAC;QAC3C,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAE3D,MAAM,SAAS,GAAG,QAAQ;aACvB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACT,MAAM,OAAO,GAAG,CAAC,CAAC,OAAO,EAAE,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC;YACrE,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,kBAAkB,EAAE,CAAC;YACxD,MAAM,OAAO,GAAG,CAAC,CAAC,OAAO;iBACtB,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;iBACvB,IAAI,EAAE;iBACN,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;YACjB,OAAO,IAAI,IAAI,OAAO,OAAO,OAAO,OAAO,EAAE,CAAC;QAChD,CAAC,CAAC;aACD,IAAI,CAAC,IAAI,CAAC,CAAC;QAEd,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,6BAA6B,QAAQ,CAAC,MAAM,QAAQ,SAAS,EAAE;iBACtE;aACF;SACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/handlers/combat.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Combat state tool handler
+ */
+import type { FoundryClient } from '../../foundry/client.js';
+export declare function handleGetCombatState(_args: Record<string, unknown>, foundryClient: FoundryClient): Promise<{
+    content: {
+        type: string;
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=combat.d.ts.map

package/dist/tools/handlers/combat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"combat.d.ts","sourceRoot":"","sources":["../../../src/tools/handlers/combat.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAG7D,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,aAAa,EAAE,aAAa;;;;;GAgD7B"}

package/dist/tools/handlers/combat.js

@@ -0,0 +1,48 @@
+/**
+ * Combat state tool handler
+ */
+import { withToolError } from './utils.js';
+export async function handleGetCombatState(_args, foundryClient) {
+    return withToolError('get combat state', async () => {
+        const combat = foundryClient.getCombatState();
+        if (!combat) {
+            return {
+                content: [{ type: 'text', text: 'No active combat encounter.' }],
+            };
+        }
+        const combatants = combat.combatants
+            .sort((a, b) => (b.initiative ?? -999) - (a.initiative ?? -999))
+            .map((c, i) => {
+            const current = combat.turn === i ? ' <-- CURRENT' : '';
+            const status = c.defeated ? ' [DEFEATED]' : c.hidden ? ' [HIDDEN]' : '';
+            const init = c.initiative !== null ? c.initiative.toString() : '?';
+            // Try to get HP/AC from worldData if actor is linked
+            let hpAc = '';
+            if (c.actorId) {
+                const actor = foundryClient.getRawActor(c.actorId);
+                if (actor) {
+                    const hp = actor.system?.attributes;
+                    const hpData = hp?.hp;
+                    const acData = hp?.ac;
+                    if (hpData) {
+                        hpAc += ` HP: ${hpData.value ?? '?'}/${hpData.max ?? '?'}`;
+                    }
+                    if (acData) {
+                        hpAc += ` AC: ${acData.value ?? '?'}`;
+                    }
+                }
+            }
+            return `${i + 1}. [${init}] **${c.name}**${hpAc}${status}${current}`;
+        })
+            .join('\n');
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `**Active Combat** — Round ${combat.round}\n\n${combatants}`,
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=combat.js.map