@lydt/geogebra-studio 0.0.0-stage → 0.4.0-rc.2

package/dist/utils/performance/instance-pool.js

@@ -0,0 +1,268 @@
+"use strict";
+/**
+ * Optimized GeoGebra Instance Pool Management
+ * GEB-9: Performance Optimization: Response Time and Resource Management
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.optimizedInstancePool = exports.OptimizedInstancePool = void 0;
+const geogebra_instance_1 = require("../geogebra-instance");
+const logger_1 = __importDefault(require("../logger"));
+const index_1 = require("./index");
+// Check if we're in MCP mode (stdio communication)
+// When piping input, process.stdin.isTTY is undefined, not false
+const isMcpMode = !process.stdin.isTTY;
+class OptimizedInstancePool {
+    static poolInstance;
+    instances = new Map();
+    config;
+    cleanupInterval;
+    defaultConfig = {
+        maxInstances: 3, // Maximum concurrent instances
+        instanceTimeout: 300000, // 5 minutes
+        maxIdleTime: 600000, // 10 minutes
+        headless: true,
+        browserArgs: [
+            '--no-sandbox',
+            '--disable-setuid-sandbox',
+            '--disable-dev-shm-usage',
+            '--disable-accelerated-2d-canvas',
+            '--no-first-run',
+            '--no-zygote',
+            '--disable-gpu',
+            '--memory-pressure-off', // Reduce memory pressure
+            '--max_old_space_size=512' // Limit memory usage
+        ]
+    };
+    constructor(config) {
+        this.config = { ...this.defaultConfig, ...config };
+        this.startCleanupTimer();
+        // Transport lifecycle owns graceful cleanup.
+        if (!isMcpMode) {
+            logger_1.default.info('Optimized Instance Pool initialized', { config: this.config });
+        }
+    }
+    static getInstance(config) {
+        if (!OptimizedInstancePool.poolInstance) {
+            OptimizedInstancePool.poolInstance = new OptimizedInstancePool(config);
+        }
+        return OptimizedInstancePool.poolInstance;
+    }
+    /**
+     * Get an available instance from the pool
+     */
+    async getInstance() {
+        return index_1.performanceMonitor.measureOperation('instance_pool_get', async () => {
+            // Try to find an available instance
+            let availableInstance = this.findAvailableInstance();
+            if (!availableInstance) {
+                // Create new instance if under limit
+                if (this.instances.size < this.config.maxInstances) {
+                    availableInstance = await this.createNewInstance();
+                }
+                else {
+                    // Wait for an instance to become available or force cleanup
+                    await this.forceCleanupOldest();
+                    availableInstance = await this.createNewInstance();
+                }
+            }
+            // Mark as active and update usage stats
+            const pooled = this.instances.get(availableInstance.id);
+            pooled.isActive = true;
+            pooled.lastUsed = new Date();
+            pooled.usageCount++;
+            logger_1.default.debug(`Instance ${availableInstance.id} acquired from pool`, {
+                totalInstances: this.instances.size,
+                activeInstances: this.getActiveCount(),
+                usageCount: pooled.usageCount
+            });
+            return availableInstance;
+        });
+    }
+    /**
+     * Release an instance back to the pool
+     */
+    async releaseInstance(instance) {
+        return index_1.performanceMonitor.measureOperation('instance_pool_release', async () => {
+            const pooled = this.instances.get(instance.id);
+            if (pooled) {
+                pooled.isActive = false;
+                pooled.lastUsed = new Date();
+                // Clear construction to reset state for next use
+                try {
+                    await instance.newConstruction();
+                }
+                catch (error) {
+                    logger_1.default.warn(`Failed to clear construction on release: ${error}`);
+                }
+                logger_1.default.debug(`Instance ${instance.id} released to pool`, {
+                    totalInstances: this.instances.size,
+                    activeInstances: this.getActiveCount()
+                });
+            }
+        });
+    }
+    /**
+     * Find an available (non-active) instance
+     */
+    findAvailableInstance() {
+        for (const [, pooled] of this.instances) {
+            if (!pooled.isActive) {
+                return pooled.instance;
+            }
+        }
+        return null;
+    }
+    /**
+     * Create a new instance and add to pool
+     */
+    async createNewInstance() {
+        return index_1.performanceMonitor.measureOperation('instance_pool_create', async () => {
+            const instance = new geogebra_instance_1.GeoGebraInstance({
+                appName: 'classic',
+                width: 800,
+                height: 600,
+                showMenuBar: false,
+                showToolBar: false,
+                showAlgebraInput: false
+            });
+            await instance.initialize(this.config.headless, this.config.browserArgs);
+            const pooled = {
+                instance,
+                isActive: false,
+                lastUsed: new Date(),
+                createdAt: new Date(),
+                usageCount: 0
+            };
+            this.instances.set(instance.id, pooled);
+            logger_1.default.info(`New instance ${instance.id} created and added to pool`, {
+                totalInstances: this.instances.size
+            });
+            return instance;
+        });
+    }
+    /**
+     * Force cleanup of the oldest instance to make room
+     */
+    async forceCleanupOldest() {
+        let oldestId = null;
+        let oldestTime = Date.now();
+        // Find oldest inactive instance
+        for (const [id, pooled] of this.instances) {
+            if (!pooled.isActive && pooled.lastUsed.getTime() < oldestTime) {
+                oldestTime = pooled.lastUsed.getTime();
+                oldestId = id;
+            }
+        }
+        // If no inactive instance, find oldest active one
+        if (!oldestId) {
+            for (const [id, pooled] of this.instances) {
+                if (pooled.lastUsed.getTime() < oldestTime) {
+                    oldestTime = pooled.lastUsed.getTime();
+                    oldestId = id;
+                }
+            }
+        }
+        if (oldestId) {
+            await this.removeInstance(oldestId);
+            logger_1.default.info(`Forced cleanup of oldest instance ${oldestId} to make room`);
+        }
+    }
+    /**
+     * Remove and cleanup an instance
+     */
+    async removeInstance(instanceId) {
+        const pooled = this.instances.get(instanceId);
+        if (pooled) {
+            try {
+                await pooled.instance.cleanup();
+            }
+            catch (error) {
+                logger_1.default.error(`Error cleaning up instance ${instanceId}:`, error);
+            }
+            this.instances.delete(instanceId);
+        }
+    }
+    /**
+     * Start automatic cleanup timer
+     */
+    startCleanupTimer() {
+        this.cleanupInterval = setInterval(() => {
+            this.performCleanup();
+        }, 60000); // Run cleanup every minute
+        this.cleanupInterval.unref();
+    }
+    /**
+     * Perform periodic cleanup of idle instances
+     */
+    async performCleanup() {
+        const now = Date.now();
+        const instancesToRemove = [];
+        for (const [id, pooled] of this.instances) {
+            const idleTime = now - pooled.lastUsed.getTime();
+            const isExpired = idleTime > this.config.maxIdleTime;
+            const isOld = (now - pooled.createdAt.getTime()) > this.config.instanceTimeout;
+            if (!pooled.isActive && (isExpired || isOld)) {
+                instancesToRemove.push(id);
+            }
+        }
+        for (const id of instancesToRemove) {
+            await this.removeInstance(id);
+            logger_1.default.debug(`Cleaned up idle instance ${id}`);
+        }
+        if (instancesToRemove.length > 0) {
+            logger_1.default.info(`Cleanup completed: removed ${instancesToRemove.length} idle instances`);
+        }
+    }
+    /**
+     * Get count of active instances
+     */
+    getActiveCount() {
+        return Array.from(this.instances.values()).filter(p => p.isActive).length;
+    }
+    /**
+     * Get pool statistics
+     */
+    getStats() {
+        const instances = Array.from(this.instances.values());
+        const now = Date.now();
+        return {
+            totalInstances: instances.length,
+            activeInstances: this.getActiveCount(),
+            averageUsage: instances.reduce((sum, p) => sum + p.usageCount, 0) / instances.length || 0,
+            oldestInstanceAge: instances.length > 0
+                ? Math.max(...instances.map(p => now - p.createdAt.getTime())) / 1000
+                : 0,
+            memoryEstimate: instances.length * 75 // Approximate 75MB per instance
+        };
+    }
+    /**
+     * Cleanup all instances and stop timers
+     */
+    async cleanup() {
+        if (this.cleanupInterval) {
+            clearInterval(this.cleanupInterval);
+            this.cleanupInterval = undefined;
+        }
+        const cleanupPromises = Array.from(this.instances.keys()).map(id => this.removeInstance(id));
+        await Promise.all(cleanupPromises);
+        logger_1.default.info('Instance pool cleaned up completely');
+    }
+    /**
+     * Warm up the pool by pre-creating instances
+     */
+    async warmUp(count = 1) {
+        const warmUpPromises = [];
+        for (let i = 0; i < count && this.instances.size < this.config.maxInstances; i++) {
+            warmUpPromises.push(this.createNewInstance().then(instance => this.releaseInstance(instance)));
+        }
+        await Promise.all(warmUpPromises);
+        logger_1.default.info(`Pool warmed up with ${count} pre-created instances`);
+    }
+}
+exports.OptimizedInstancePool = OptimizedInstancePool;
+// Global optimized pool instance
+exports.optimizedInstancePool = OptimizedInstancePool.getInstance();
+//# sourceMappingURL=instance-pool.js.map

package/dist/utils/performance/instance-pool.js.map

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

package/dist/utils/validation.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Validation utilities for GeoGebra MCP tools
+ */
+export interface ValidationResult {
+    isValid: boolean;
+    error?: string;
+}
+/**
+ * Validate point name (GeoGebra naming conventions)
+ */
+export declare function validatePointName(name: string): ValidationResult;
+/**
+ * Validate object name (general GeoGebra naming conventions)
+ */
+export declare function validateObjectName(name: string): ValidationResult;
+/**
+ * Validate coordinates
+ */
+export declare function validateCoordinates(x: number, y: number): ValidationResult;
+/**
+ * Validate radius
+ */
+export declare function validateRadius(radius: number): ValidationResult;
+/**
+ * Validate polygon vertices
+ */
+export declare function validatePolygonVertices(vertices: string[]): ValidationResult;
+/**
+ * Validate linear equation format
+ */
+export declare function validateLinearEquation(equation: string): ValidationResult;
+/**
+ * Validate that required parameters are provided for a given method
+ */
+export declare function validateRequiredParams(params: Record<string, unknown>, required: string[]): ValidationResult;
+/**
+ * Validate function expression for standard functions f(x) = ...
+ */
+export declare function validateFunctionExpression(expression: string): ValidationResult;
+/**
+ * Validate parametric function expressions
+ */
+export declare function validateParametricExpressions(xExpr: string, yExpr: string, parameter: string): ValidationResult;
+/**
+ * Validate implicit function expression
+ */
+export declare function validateImplicitExpression(expression: string): ValidationResult;
+/**
+ * Validate domain range parameters
+ */
+export declare function validateDomainRange(min: number, max: number, paramName?: string): ValidationResult;
+/**
+ * Validate function styling parameters
+ */
+export declare function validateFunctionStyling(color?: string, thickness?: number, style?: string): ValidationResult;
+/**
+ * Validate algebraic expression for CAS operations
+ */
+export declare function validateAlgebraicExpression(expression: string): ValidationResult;
+/**
+ * Validate equation format for solving
+ */
+export declare function validateEquation(equation: string): ValidationResult;
+/**
+ * Validate variable name for CAS operations
+ */
+export declare function validateVariableName(variable: string): ValidationResult;
+/**
+ * Validate system of equations
+ */
+export declare function validateSystemOfEquations(equations: string[]): ValidationResult;
+/**
+ * Validate variables list for system solving
+ */
+export declare function validateVariablesList(variables: string[]): ValidationResult;
+/**
+ * Validates slider parameters for creation
+ */
+export declare function validateSliderParameters(name: string, min: number, max: number, increment?: number, defaultValue?: number): ValidationResult;
+/**
+ * Validates animation speed parameter
+ */
+export declare function validateAnimationSpeed(speed: number): ValidationResult;
+/**
+ * Validates animation direction parameter
+ */
+export declare function validateAnimationDirection(direction?: string): ValidationResult;
+/**
+ * Validates parameters for animation export
+ */
+export declare function validateAnimationExportParameters(frameCount: number, frameDelay: number, totalDuration?: number): ValidationResult;
+//# sourceMappingURL=validation.d.ts.map

package/dist/utils/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAgBhE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAEjE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAgB1E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAkB/D;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,gBAAgB,CAgC5E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CA6BzE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,gBAAgB,CAO5G;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,MAAM,GAAG,gBAAgB,CA+B/E;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,gBAAgB,CAwB/G;AAuCD;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,MAAM,GAAG,gBAAgB,CAmC/E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,GAAE,MAAoB,GAAG,gBAAgB,CA6B/G;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAuC5G;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,gBAAgB,CAiChF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CAmCnE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CA0BvE;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,gBAAgB,CA0B/E;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,gBAAgB,CAgC3E;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,SAAS,CAAC,EAAE,MAAM,EAClB,YAAY,CAAC,EAAE,MAAM,GACpB,gBAAgB,CAuBlB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,CAUtE;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAM/E;AAED;;GAEG;AACH,wBAAgB,iCAAiC,CAC/C,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,aAAa,CAAC,EAAE,MAAM,GACrB,gBAAgB,CAkBlB"}