foundryvtt-mcp 0.11.0

package/dist/combat/manager.js

@@ -0,0 +1,373 @@
+import { EventEmitter } from 'node:events';
+import { logger } from '../utils/logger.js';
+export class CombatManager extends EventEmitter {
+    foundryClient;
+    currentCombat = null;
+    combatHistory = [];
+    turnTimer;
+    TURN_WARNING_TIME = 30000; // 30 seconds
+    constructor(foundryClient) {
+        super();
+        this.foundryClient = foundryClient;
+        this.setupEventHandlers();
+    }
+    setupEventHandlers() {
+        this.on('combat_start', this.handleCombatStart.bind(this));
+        this.on('turn_start', this.handleTurnStart.bind(this));
+        this.on('turn_end', this.handleTurnEnd.bind(this));
+        this.on('round_end', this.handleRoundEnd.bind(this));
+    }
+    /**
+     * Destroy the combat manager and release resources
+     */
+    destroy() {
+        if (this.turnTimer) {
+            clearTimeout(this.turnTimer);
+            this.turnTimer = undefined;
+        }
+        this.removeAllListeners();
+        this.currentCombat = null;
+        this.combatHistory = [];
+        logger.info('Combat manager destroyed');
+    }
+    // Public API Methods
+    getCurrentCombat() {
+        return this.currentCombat;
+    }
+    getCombatHistory(limit = 50) {
+        return this.combatHistory.slice(-limit);
+    }
+    async startCombat(combatants) {
+        logger.info('Starting new combat encounter');
+        const combat = {
+            id: this.generateCombatId(),
+            round: 1,
+            turn: 0,
+            active: true,
+            started: false,
+            combatants: await this.initializeCombatants(combatants),
+            turnStartTime: new Date(),
+            roundStartTime: new Date(),
+        };
+        // Sort by initiative
+        combat.combatants.sort((a, b) => (b.initiative || 0) - (a.initiative || 0));
+        this.currentCombat = combat;
+        this.emitCombatEvent('combat_start', combat);
+        return combat;
+    }
+    async rollInitiative(combatantId) {
+        if (!this.currentCombat) {
+            throw new Error('No active combat');
+        }
+        const results = {};
+        const combatants = combatantId
+            ? this.currentCombat.combatants.filter((c) => c.id === combatantId)
+            : this.currentCombat.combatants;
+        for (const combatant of combatants) {
+            // Roll 1d20 + initiative modifier (simplified)
+            const roll = Math.floor(Math.random() * 20) + 1;
+            const modifier = this.getInitiativeModifier(combatant);
+            const total = roll + modifier;
+            combatant.initiative = total;
+            results[combatant.name] = total;
+            logger.debug(`${combatant.name} rolled initiative: ${total} (${roll} + ${modifier})`);
+        }
+        // Re-sort combatants by initiative
+        this.currentCombat.combatants.sort((a, b) => (b.initiative || 0) - (a.initiative || 0));
+        this.emitCombatEvent('initiative_changed', this.currentCombat, results);
+        return results;
+    }
+    async nextTurn() {
+        if (!this.currentCombat || !this.currentCombat.active) {
+            throw new Error('No active combat');
+        }
+        // End current turn
+        if (this.currentCombat.currentCombatant) {
+            this.emitCombatEvent('turn_end', this.currentCombat);
+        }
+        // Clear turn timer
+        if (this.turnTimer) {
+            clearTimeout(this.turnTimer);
+        }
+        // Advance to next combatant
+        this.currentCombat.turn++;
+        // Check if we need to start a new round
+        if (this.currentCombat.turn >= this.currentCombat.combatants.length) {
+            this.currentCombat.turn = 0;
+            this.currentCombat.round++;
+            this.emitCombatEvent('round_end', this.currentCombat);
+            // Reset turn actions for all combatants
+            this.currentCombat.combatants.forEach((c) => {
+                c.turnTaken = false;
+                c.actions = {
+                    action: false,
+                    bonus: false,
+                    movement: 0,
+                    reaction: false,
+                };
+            });
+        }
+        // Set current combatant
+        const combatant = this.currentCombat.combatants[this.currentCombat.turn];
+        if (combatant) {
+            this.currentCombat.currentCombatant = combatant;
+        }
+        this.currentCombat.turnStartTime = new Date();
+        if (!this.currentCombat.started) {
+            this.currentCombat.started = true;
+        }
+        this.emitCombatEvent('turn_start', this.currentCombat);
+        return this.currentCombat.currentCombatant || null;
+    }
+    async applyDamage(combatantId, damage, damageType) {
+        if (!this.currentCombat) {
+            throw new Error('No active combat');
+        }
+        const combatant = this.currentCombat.combatants.find((c) => c.id === combatantId);
+        if (!combatant) {
+            throw new Error(`Combatant ${combatantId} not found`);
+        }
+        // Apply damage to temp HP first, then regular HP
+        let remainingDamage = damage;
+        if (combatant.hp.temp && combatant.hp.temp > 0) {
+            const tempDamage = Math.min(remainingDamage, combatant.hp.temp);
+            combatant.hp.temp -= tempDamage;
+            remainingDamage -= tempDamage;
+        }
+        combatant.hp.current = Math.max(0, combatant.hp.current - remainingDamage);
+        // Check if combatant is defeated
+        if (combatant.hp.current === 0) {
+            combatant.defeated = true;
+        }
+        this.emitCombatEvent('damage_dealt', this.currentCombat, {
+            combatantId,
+            damage,
+            damageType,
+            newHP: combatant.hp.current,
+            defeated: combatant.defeated,
+        });
+        logger.info(`${combatant.name} took ${damage} ${damageType || 'damage'}, HP: ${combatant.hp.current}/${combatant.hp.max}`);
+        return combatant;
+    }
+    async healCombatant(combatantId, healing) {
+        if (!this.currentCombat) {
+            throw new Error('No active combat');
+        }
+        const combatant = this.currentCombat.combatants.find((c) => c.id === combatantId);
+        if (!combatant) {
+            throw new Error(`Combatant ${combatantId} not found`);
+        }
+        combatant.hp.current = Math.min(combatant.hp.max, combatant.hp.current + healing);
+        if (combatant.hp.current > 0) {
+            combatant.defeated = false;
+        }
+        logger.info(`${combatant.name} healed for ${healing}, HP: ${combatant.hp.current}/${combatant.hp.max}`);
+        return combatant;
+    }
+    async applyCondition(combatantId, condition, duration) {
+        if (!this.currentCombat) {
+            throw new Error('No active combat');
+        }
+        const combatant = this.currentCombat.combatants.find((c) => c.id === combatantId);
+        if (!combatant) {
+            throw new Error(`Combatant ${combatantId} not found`);
+        }
+        if (!combatant.conditions.includes(condition)) {
+            combatant.conditions.push(condition);
+            this.emitCombatEvent('condition_applied', this.currentCombat, {
+                combatantId,
+                condition,
+                duration,
+            });
+            logger.info(`Applied ${condition} to ${combatant.name}`);
+        }
+        return combatant;
+    }
+    async removeCondition(combatantId, condition) {
+        if (!this.currentCombat) {
+            throw new Error('No active combat');
+        }
+        const combatant = this.currentCombat.combatants.find((c) => c.id === combatantId);
+        if (!combatant) {
+            throw new Error(`Combatant ${combatantId} not found`);
+        }
+        const index = combatant.conditions.indexOf(condition);
+        if (index > -1) {
+            combatant.conditions.splice(index, 1);
+            logger.info(`Removed ${condition} from ${combatant.name}`);
+        }
+        return combatant;
+    }
+    async endCombat() {
+        if (!this.currentCombat) {
+            throw new Error('No active combat');
+        }
+        this.currentCombat.active = false;
+        if (this.turnTimer) {
+            clearTimeout(this.turnTimer);
+        }
+        const endedCombat = { ...this.currentCombat };
+        this.emitCombatEvent('combat_end', endedCombat);
+        logger.info('Combat ended');
+        this.currentCombat = null;
+        return endedCombat;
+    }
+    // Event Handlers
+    handleCombatStart(event) {
+        logger.info(`Combat started with ${event.combat.combatants.length} combatants`);
+    }
+    handleTurnStart(event) {
+        const combatant = event.combat.currentCombatant;
+        if (combatant) {
+            logger.info(`Turn ${event.combat.turn + 1}, Round ${event.combat.round}: ${combatant.name}'s turn`);
+            // Set turn timer
+            this.turnTimer = setTimeout(() => {
+                this.emit('turn_warning', combatant);
+            }, this.TURN_WARNING_TIME);
+        }
+    }
+    handleTurnEnd(event) {
+        const combatant = event.combat.currentCombatant;
+        if (combatant) {
+            combatant.turnTaken = true;
+            logger.debug(`${combatant.name} ended their turn`);
+        }
+    }
+    handleRoundEnd(event) {
+        logger.info(`Round ${event.combat.round - 1} ended, starting Round ${event.combat.round}`);
+    }
+    // Helper Methods
+    async initializeCombatants(combatantData) {
+        const combatants = [];
+        for (const data of combatantData) {
+            const combatant = {
+                id: data.id || this.generateCombatantId(),
+                name: data.name || 'Unknown',
+                initiative: data.initiative || 0,
+                hp: data.hp || { current: 1, max: 1 },
+                ac: data.ac || 10,
+                conditions: data.conditions || [],
+                defeated: data.defeated || false,
+                hidden: data.hidden || false,
+                actorId: data.actorId || '',
+                tokenId: data.tokenId || '',
+                turnTaken: false,
+                actions: {
+                    action: false,
+                    bonus: false,
+                    movement: 0,
+                    reaction: false,
+                },
+            };
+            combatants.push(combatant);
+        }
+        return combatants;
+    }
+    getInitiativeModifier(_combatant) {
+        // Simplified initiative modifier calculation
+        // In a real implementation, this would pull from the actual character sheet
+        return Math.floor(Math.random() * 6) - 1; // -1 to +4
+    }
+    generateCombatId() {
+        return `combat_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+    }
+    generateCombatantId() {
+        return `combatant_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+    }
+    emitCombatEvent(type, combat, data) {
+        const event = {
+            type,
+            timestamp: new Date(),
+            combat: { ...combat }, // Deep copy to prevent mutations
+            data,
+        };
+        this.combatHistory.push(event);
+        // Keep history manageable
+        if (this.combatHistory.length > 1000) {
+            this.combatHistory = this.combatHistory.slice(-500);
+        }
+        this.emit(type, event);
+        this.emit('combat_event', event);
+    }
+    // Analysis Methods
+    getCombatStatistics() {
+        if (!this.currentCombat) {
+            return null;
+        }
+        const stats = {
+            totalRounds: this.currentCombat.round,
+            totalTurns: this.currentCombat.round * this.currentCombat.combatants.length + this.currentCombat.turn,
+            averageTurnTime: this.calculateAverageTurnTime(),
+            combatants: this.currentCombat.combatants.map((c) => ({
+                name: c.name,
+                initiative: c.initiative || 0,
+                hp: { current: c.hp.current, max: c.hp.max },
+                status: c.conditions,
+            })),
+            activeEffects: this.currentCombat.combatants.reduce((acc, c) => acc + c.conditions.length, 0),
+        };
+        return stats;
+    }
+    calculateAverageTurnTime() {
+        const turnEvents = this.combatHistory.filter((e) => e.type === 'turn_start');
+        if (turnEvents.length < 2) {
+            return 0;
+        }
+        let totalTime = 0;
+        for (let i = 1; i < turnEvents.length; i++) {
+            const currentEvent = turnEvents[i];
+            const previousEvent = turnEvents[i - 1];
+            if (currentEvent && previousEvent) {
+                totalTime += currentEvent.timestamp.getTime() - previousEvent.timestamp.getTime();
+            }
+        }
+        return Math.round(totalTime / (turnEvents.length - 1) / 1000); // seconds
+    }
+    suggestTacticalActions(combatantId) {
+        if (!this.currentCombat) {
+            return ['No active combat'];
+        }
+        const combatant = this.currentCombat.combatants.find((c) => c.id === combatantId);
+        if (!combatant) {
+            return ['Combatant not found'];
+        }
+        const suggestions = [];
+        // HP-based suggestions
+        const hpPercent = (combatant.hp.current / combatant.hp.max) * 100;
+        if (hpPercent < 25) {
+            suggestions.push('Consider healing or retreating - HP critically low');
+            suggestions.push('Use defensive actions like Dodge or Shield');
+        }
+        else if (hpPercent < 50) {
+            suggestions.push('Monitor HP carefully - consider healing');
+        }
+        // Condition-based suggestions
+        if (combatant.conditions.includes('poisoned')) {
+            suggestions.push('Remove poison condition if possible');
+        }
+        if (combatant.conditions.includes('prone')) {
+            suggestions.push('Use movement to stand up from prone');
+        }
+        if (combatant.conditions.includes('grappled')) {
+            suggestions.push('Attempt to escape grapple with Athletics or Acrobatics');
+        }
+        // Action economy suggestions
+        if (!combatant.actions.action) {
+            suggestions.push('Use your Action for Attack, Cast a Spell, or other actions');
+        }
+        if (!combatant.actions.bonus) {
+            suggestions.push('Check for available Bonus Actions');
+        }
+        // Enemy analysis
+        const enemies = this.currentCombat.combatants.filter((c) => c.id !== combatantId && !c.defeated);
+        const lowHpEnemies = enemies.filter((e) => e.hp.current / e.hp.max < 0.3);
+        if (lowHpEnemies.length > 0) {
+            suggestions.push(`Focus fire on low HP enemies: ${lowHpEnemies.map((e) => e.name).join(', ')}`);
+        }
+        if (suggestions.length === 0) {
+            suggestions.push('Assess battlefield and choose optimal action');
+        }
+        return suggestions;
+    }
+}
+//# sourceMappingURL=manager.js.map

package/dist/combat/manager.js.map

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

package/dist/config/index.d.ts

@@ -0,0 +1,114 @@
+/**
+ * @fileoverview Configuration management for FoundryVTT MCP Server
+ *
+ * This module handles loading and validating configuration from environment variables
+ * using Zod schemas for type safety and runtime validation.
+ *
+ * @version 0.1.0
+ * @author FoundryVTT MCP Team
+ */
+import { z } from 'zod';
+/**
+ * Zod schema for validating server configuration
+ *
+ * Defines the structure and validation rules for all configuration options,
+ * including server settings, FoundryVTT connection details, and caching options.
+ */
+declare const ConfigSchema: z.ZodObject<{
+    serverName: z.ZodDefault<z.ZodString>;
+    serverVersion: z.ZodDefault<z.ZodString>;
+    logLevel: z.ZodDefault<z.ZodEnum<{
+        debug: "debug";
+        info: "info";
+        warn: "warn";
+        error: "error";
+    }>>;
+    nodeEnv: z.ZodDefault<z.ZodEnum<{
+        development: "development";
+        production: "production";
+        test: "test";
+    }>>;
+    foundry: z.ZodObject<{
+        url: z.ZodString;
+        apiKey: z.ZodOptional<z.ZodString>;
+        username: z.ZodOptional<z.ZodString>;
+        password: z.ZodOptional<z.ZodString>;
+        userId: z.ZodOptional<z.ZodString>;
+        socketPath: z.ZodDefault<z.ZodString>;
+        timeout: z.ZodDefault<z.ZodNumber>;
+        retryAttempts: z.ZodDefault<z.ZodNumber>;
+        retryDelay: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>;
+    cache: z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        ttlSeconds: z.ZodDefault<z.ZodNumber>;
+        maxSize: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/**
+ * TypeScript type derived from the ConfigSchema
+ *
+ * This type provides compile-time type checking for configuration objects
+ * and ensures consistency between the schema and type definitions.
+ */
+type Config = z.infer<typeof ConfigSchema>;
+/**
+ * Gets the global configuration instance
+ *
+ * This loads and caches the configuration on first access, allowing tests
+ * to set environment variables before triggering configuration validation.
+ *
+ * @returns Validated configuration object
+ * @example
+ * ```typescript
+ * import { config } from './config/index.js';
+ *
+ * console.log(`Connecting to ${config.foundry.url}`);
+ * if (config.foundry.apiKey) {
+ *   console.log('Using local REST API module with API key');
+ * } else {
+ *   console.log('Using WebSocket connection with username/password');
+ * }
+ * ```
+ */
+export declare const config: {
+    serverName: string;
+    serverVersion: string;
+    logLevel: "debug" | "info" | "warn" | "error";
+    nodeEnv: "development" | "production" | "test";
+    foundry: {
+        url: string;
+        socketPath: string;
+        timeout: number;
+        retryAttempts: number;
+        retryDelay: number;
+        apiKey?: string | undefined;
+        username?: string | undefined;
+        password?: string | undefined;
+        userId?: string | undefined;
+    };
+    cache: {
+        enabled: boolean;
+        ttlSeconds: number;
+        maxSize: number;
+    };
+};
+/**
+ * Resets the cached configuration - used for testing
+ * @internal
+ */
+export declare function resetConfig(): void;
+/**
+ * Export the Config type for use in other modules
+ *
+ * @example
+ * ```typescript
+ * import type { Config } from './config/index.js';
+ *
+ * function processConfig(cfg: Config) {
+ *   // Process configuration
+ * }
+ * ```
+ */
+export type { Config };
+//# sourceMappingURL=index.d.ts.map

package/dist/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;GAKG;AACH,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAgDhB,CAAC;AAEH;;;;;GAKG;AACH,KAAK,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAyF3C;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;CAOjB,CAAC;AAEH;;;GAGG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAElC;AAED;;;;;;;;;;;GAWG;AACH,YAAY,EAAE,MAAM,EAAE,CAAC"}