equilibria-mcp-server 1.0.0

package/dist/tools/validation.js

@@ -0,0 +1,181 @@
+/**
+ * Validation Tools
+ *
+ * Tools for validating expressions, documents, and economic constraints.
+ */
+import { validateExpression, validateDocument, checkCircularDependencies, } from '../validation/index.js';
+/**
+ * Tool: validate_expression
+ *
+ * Validates a mathematical expression for syntax and parameter references.
+ */
+const validateExpressionTool = {
+    tool: {
+        name: 'validate_expression',
+        description: 'Validate a mathematical expression for syntax errors and check if referenced parameters exist.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                expression: {
+                    type: 'string',
+                    description: 'The mathematical expression to validate',
+                },
+                availableParameters: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'List of available parameter names',
+                },
+                allowX: {
+                    type: 'boolean',
+                    description: 'Allow "x" as a variable (for equations)',
+                    default: true,
+                },
+            },
+            required: ['expression'],
+        },
+    },
+    handler: async (args, _context) => {
+        const expression = args.expression;
+        const availableParams = args.availableParameters || [];
+        const allowX = args.allowX !== false;
+        const result = validateExpression(expression, availableParams, allowX);
+        if (result.valid) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Expression is valid.\n\nParsed symbols: ${result.symbols.join(', ') || 'none'}`,
+                    },
+                ],
+            };
+        }
+        let output = 'Expression validation failed:\n\n';
+        for (const error of result.errors) {
+            output += `- ${error.message}`;
+            if (error.suggestion) {
+                output += ` (Suggestion: ${error.suggestion})`;
+            }
+            output += '\n';
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: output,
+                },
+            ],
+            isError: true,
+        };
+    },
+};
+/**
+ * Tool: validate_yaml
+ *
+ * Validates YAML content against the Equilibria schema.
+ */
+const validateYAML = {
+    tool: {
+        name: 'validate_yaml',
+        description: 'Validate YAML content against the Equilibria document schema. Returns detailed error messages with suggestions.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                yaml: {
+                    type: 'string',
+                    description: 'The YAML content to validate',
+                },
+            },
+            required: ['yaml'],
+        },
+    },
+    handler: async (args, _context) => {
+        const yaml = args.yaml;
+        const result = validateDocument(yaml);
+        if (result.valid) {
+            let output = 'Document is valid!\n';
+            if (result.warnings.length > 0) {
+                output += '\nWarnings:\n';
+                for (const warning of result.warnings) {
+                    output += `- ${warning.path}: ${warning.message}\n`;
+                }
+            }
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: output,
+                    },
+                ],
+            };
+        }
+        let output = 'Validation failed:\n\n';
+        for (const error of result.errors) {
+            output += `**${error.path}**\n`;
+            output += `  ${error.message}\n`;
+            if (error.suggestion) {
+                output += `  Suggestion: ${error.suggestion}\n`;
+            }
+            output += '\n';
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: output,
+                },
+            ],
+            isError: true,
+        };
+    },
+};
+/**
+ * Tool: check_dependencies
+ *
+ * Checks for circular dependencies in parameter definitions.
+ */
+const checkDependencies = {
+    tool: {
+        name: 'check_dependencies',
+        description: 'Check for circular dependencies in parameter expressions. Circular dependencies cause infinite loops and must be avoided.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                parameters: {
+                    type: 'object',
+                    description: 'Map of parameter names to their expressions. E.g., {"a": "b + 1", "b": "c * 2", "c": "10"}',
+                    additionalProperties: { type: 'string' },
+                },
+            },
+            required: ['parameters'],
+        },
+    },
+    handler: async (args, _context) => {
+        const parameters = args.parameters;
+        const result = checkCircularDependencies(parameters);
+        if (result.valid) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `No circular dependencies found.\n\nEvaluation order: ${result.order.join(' -> ')}`,
+                    },
+                ],
+            };
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Circular dependency detected!\n\nCycle: ${result.cycle.join(' -> ')} -> ${result.cycle[0]}`,
+                },
+            ],
+            isError: true,
+        };
+    },
+};
+export const validationTools = [
+    validateExpressionTool,
+    validateYAML,
+    checkDependencies,
+];
+//# sourceMappingURL=validation.js.map

package/dist/tools/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/tools/validation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,yBAAyB,GAC1B,MAAM,wBAAwB,CAAC;AAEhC;;;;GAIG;AACH,MAAM,sBAAsB,GAAqB;IAC/C,IAAI,EAAE;QACJ,IAAI,EAAE,qBAAqB;QAC3B,WAAW,EACT,gGAAgG;QAClG,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,yCAAyC;iBACvD;gBACD,mBAAmB,EAAE;oBACnB,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACzB,WAAW,EAAE,mCAAmC;iBACjD;gBACD,MAAM,EAAE;oBACN,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,yCAAyC;oBACtD,OAAO,EAAE,IAAI;iBACd;aACF;YACD,QAAQ,EAAE,CAAC,YAAY,CAAC;SACzB;KACF;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;QAChC,MAAM,UAAU,GAAG,IAAI,CAAC,UAAoB,CAAC;QAC7C,MAAM,eAAe,GAAI,IAAI,CAAC,mBAAgC,IAAI,EAAE,CAAC;QACrE,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC;QAErC,MAAM,MAAM,GAAG,kBAAkB,CAAC,UAAU,EAAE,eAAe,EAAE,MAAM,CAAC,CAAC;QAEvE,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACjB,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,2CAA2C,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,EAAE;qBACvF;iBACF;aACF,CAAC;QACJ,CAAC;QAED,IAAI,MAAM,GAAG,mCAAmC,CAAC;QACjD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;YAC/B,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;gBACrB,MAAM,IAAI,iBAAiB,KAAK,CAAC,UAAU,GAAG,CAAC;YACjD,CAAC;YACD,MAAM,IAAI,IAAI,CAAC;QACjB,CAAC;QAED,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,MAAM;iBACb;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;CACF,CAAC;AAEF;;;;GAIG;AACH,MAAM,YAAY,GAAqB;IACrC,IAAI,EAAE;QACJ,IAAI,EAAE,eAAe;QACrB,WAAW,EACT,iHAAiH;QACnH,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,8BAA8B;iBAC5C;aACF;YACD,QAAQ,EAAE,CAAC,MAAM,CAAC;SACnB;KACF;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;QAChC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAc,CAAC;QAEjC,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;QAEtC,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACjB,IAAI,MAAM,GAAG,sBAAsB,CAAC;YACpC,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC/B,MAAM,IAAI,eAAe,CAAC;gBAC1B,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;oBACtC,MAAM,IAAI,KAAK,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,OAAO,IAAI,CAAC;gBACtD,CAAC;YACH,CAAC;YACD,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,MAAM;qBACb;iBACF;aACF,CAAC;QACJ,CAAC;QAED,IAAI,MAAM,GAAG,wBAAwB,CAAC;QACtC,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,KAAK,CAAC,IAAI,MAAM,CAAC;YAChC,MAAM,IAAI,KAAK,KAAK,CAAC,OAAO,IAAI,CAAC;YACjC,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;gBACrB,MAAM,IAAI,iBAAiB,KAAK,CAAC,UAAU,IAAI,CAAC;YAClD,CAAC;YACD,MAAM,IAAI,IAAI,CAAC;QACjB,CAAC;QAED,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,MAAM;iBACb;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;CACF,CAAC;AAEF;;;;GAIG;AACH,MAAM,iBAAiB,GAAqB;IAC1C,IAAI,EAAE;QACJ,IAAI,EAAE,oBAAoB;QAC1B,WAAW,EACT,2HAA2H;QAC7H,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,4FAA4F;oBAC9F,oBAAoB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;iBACzC;aACF;YACD,QAAQ,EAAE,CAAC,YAAY,CAAC;SACzB;KACF;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;QAChC,MAAM,UAAU,GAAG,IAAI,CAAC,UAAoC,CAAC;QAE7D,MAAM,MAAM,GAAG,yBAAyB,CAAC,UAAU,CAAC,CAAC;QAErD,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACjB,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,wDAAwD,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE;qBAC1F;iBACF;aACF,CAAC;QACJ,CAAC;QAED,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,2CAA2C,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;iBACnG;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAuB;IACjD,sBAAsB;IACtB,YAAY;IACZ,iBAAiB;CAClB,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,187 @@
+/**
+ * Type Definitions for Equilibria MCP Server
+ *
+ * Core types used across the MCP server implementation.
+ */
+import type { Tool, CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type { Document as EquilibriaDocument } from 'equilibria-engine';
+/**
+ * Output format types supported by the MCP server
+ */
+export type OutputFormat = 'yaml' | 'redux' | 'api';
+/**
+ * Economic model categories
+ */
+export type ModelCategory = 'supply_demand' | 'production' | 'consumer_theory' | 'market_structures' | 'macro' | 'international' | 'finance' | 'behavioral' | 'inequality';
+/**
+ * Economic education level
+ */
+export type EducationLevel = 'high_school' | 'undergraduate' | 'postgraduate';
+/**
+ * Economic model template metadata
+ */
+export interface ModelTemplate {
+    /** Unique identifier for the model */
+    id: string;
+    /** Human-readable name */
+    name: string;
+    /** Brief description */
+    description: string;
+    /** Model category */
+    category: ModelCategory;
+    /** Target education level */
+    level: EducationLevel;
+    /** Available parameters and their defaults */
+    parameters: Record<string, ParameterDefinition>;
+    /** Tags for searchability */
+    tags: string[];
+    /** Generator function */
+    generate: (params: Record<string, unknown>) => EquilibriaDocument;
+}
+/**
+ * Parameter definition for model templates
+ */
+export interface ParameterDefinition {
+    /** Parameter type */
+    type: 'number' | 'string' | 'boolean';
+    /** Default value */
+    default: number | string | boolean;
+    /** Minimum value (for numbers) */
+    min?: number;
+    /** Maximum value (for numbers) */
+    max?: number;
+    /** Description */
+    description: string;
+    /** Whether parameter is required */
+    required?: boolean;
+}
+/**
+ * Shared context passed to tool handlers
+ */
+export interface MCPToolContext {
+    /** Current document being built (for incremental construction) */
+    currentDocument: Partial<EquilibriaDocument> | null;
+    /** Session state for multi-step operations */
+    sessionState: Map<string, unknown>;
+}
+/**
+ * Tool handler function signature
+ */
+export type ToolHandler = (args: Record<string, unknown>, context: MCPToolContext) => Promise<CallToolResult>;
+/**
+ * Tool registration entry
+ */
+export interface ToolRegistration {
+    /** Tool definition for MCP */
+    tool: Tool;
+    /** Handler function */
+    handler: ToolHandler;
+}
+/**
+ * Validation error with details
+ */
+export interface ValidationError {
+    /** Error path (e.g., "charts[0].elements[1].equation") */
+    path: string;
+    /** Error message */
+    message: string;
+    /** Suggested fix (if available) */
+    suggestion?: string;
+}
+/**
+ * Result of document validation
+ */
+export interface ValidationResult {
+    /** Whether document is valid */
+    valid: boolean;
+    /** List of errors (if invalid) */
+    errors: ValidationError[];
+    /** Warnings (non-fatal issues) */
+    warnings: ValidationError[];
+}
+/**
+ * Economic formula definition
+ */
+export interface EconomicFormula {
+    /** Formula identifier */
+    id: string;
+    /** Human-readable name */
+    name: string;
+    /** Math.js expression */
+    expression: string;
+    /** Required input parameters */
+    inputs: string[];
+    /** Output description */
+    output: string;
+    /** Category of formula */
+    category: string;
+    /** Additional notes */
+    notes?: string;
+}
+/**
+ * Builder state for incremental document construction
+ */
+export interface BuilderState {
+    /** Document metadata */
+    metadata: {
+        title?: string;
+        description?: string;
+        specVersion: string;
+    };
+    /** Global parameters */
+    parameters: Record<string, ParameterConfig>;
+    /** Charts in the document */
+    charts: ChartConfig[];
+}
+/**
+ * Parameter configuration for builder
+ */
+export interface ParameterConfig {
+    value?: number | string | boolean;
+    expression?: string;
+    min?: number;
+    max?: number;
+    step?: number;
+    label?: string;
+    hidden?: boolean;
+}
+/**
+ * Chart configuration for builder
+ */
+export interface ChartConfig {
+    id: string;
+    title?: string;
+    parameters?: Record<string, ParameterConfig>;
+    xAxis: AxisConfig;
+    yAxis: AxisConfig;
+    elements: ElementConfig[];
+    annotations?: AnnotationConfig[];
+}
+/**
+ * Axis configuration
+ */
+export interface AxisConfig {
+    label: string;
+    min: number | string;
+    max: number | string;
+    ticks?: number;
+}
+/**
+ * Element configuration (generic)
+ */
+export interface ElementConfig {
+    id: string;
+    type: string;
+    [key: string]: unknown;
+}
+/**
+ * Annotation configuration
+ */
+export interface AnnotationConfig {
+    id: string;
+    text: string;
+    x: number | string;
+    y: number | string;
+    [key: string]: unknown;
+}
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/types/index.js

@@ -0,0 +1,7 @@
+/**
+ * Type Definitions for Equilibria MCP Server
+ *
+ * Core types used across the MCP server implementation.
+ */
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/utils/cache.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Validation Cache
+ *
+ * Caches validation results to avoid redundant computations.
+ * Uses LRU eviction to bound memory usage.
+ */
+/**
+ * Cache statistics
+ */
+export interface CacheStats {
+    hits: number;
+    misses: number;
+    size: number;
+    maxSize: number;
+    hitRate: number;
+}
+/**
+ * Validation cache with LRU eviction
+ */
+export declare class ValidationCache<T> {
+    private cache;
+    private hits;
+    private misses;
+    private maxSize;
+    private ttl;
+    /**
+     * Create a validation cache
+     * @param maxSize Maximum number of entries
+     * @param ttl Time-to-live in milliseconds (0 = no expiration)
+     */
+    constructor(maxSize?: number, ttl?: number);
+    /**
+     * Generate cache key from input
+     */
+    private generateKey;
+    /**
+     * Check if entry is expired
+     */
+    private isExpired;
+    /**
+     * Evict least recently used entries
+     */
+    private evictLRU;
+    /**
+     * Get a cached value
+     */
+    get(input: unknown): T | undefined;
+    /**
+     * Set a cached value
+     */
+    set(input: unknown, value: T): void;
+    /**
+     * Get or compute a value
+     */
+    getOrCompute(input: unknown, compute: () => T): T;
+    /**
+     * Get or compute a value (async)
+     */
+    getOrComputeAsync(input: unknown, compute: () => Promise<T>): Promise<T>;
+    /**
+     * Check if key exists
+     */
+    has(input: unknown): boolean;
+    /**
+     * Delete a cached value
+     */
+    delete(input: unknown): boolean;
+    /**
+     * Clear all cached values
+     */
+    clear(): void;
+    /**
+     * Get cache statistics
+     */
+    getStats(): CacheStats;
+    /**
+     * Remove expired entries
+     */
+    cleanup(): number;
+}
+/**
+ * Pre-configured caches for common use cases
+ */
+export declare const expressionCache: ValidationCache<{
+    valid: boolean;
+    errors: unknown[];
+    symbols: string[];
+}>;
+export declare const documentCache: ValidationCache<{
+    valid: boolean;
+    errors: unknown[];
+    warnings: unknown[];
+}>;
+export declare const templateCache: ValidationCache<unknown>;
+/**
+ * Create a validation cache with custom configuration
+ */
+export declare function createValidationCache<T>(maxSize?: number, ttl?: number): ValidationCache<T>;
+//# sourceMappingURL=cache.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/utils/cache.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,qBAAa,eAAe,CAAC,CAAC;IAC5B,OAAO,CAAC,KAAK,CAAyC;IACtD,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,GAAG,CAAS;IAEpB;;;;OAIG;gBACS,OAAO,SAAO,EAAE,GAAG,SAAI;IAKnC;;OAEG;IACH,OAAO,CAAC,WAAW;IAOnB;;OAEG;IACH,OAAO,CAAC,SAAS;IAKjB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAmBhB;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,OAAO,GAAG,CAAC,GAAG,SAAS;IAoBlC;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAenC;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC;IAWjD;;OAEG;IACG,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAW9E;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IAa5B;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IAK/B;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACH,QAAQ,IAAI,UAAU;IAWtB;;OAEG;IACH,OAAO,IAAI,MAAM;CAYlB;AAED;;GAEG;AAGH,eAAO,MAAM,eAAe;WACnB,OAAO;YACN,OAAO,EAAE;aACR,MAAM,EAAE;EACT,CAAC;AAGX,eAAO,MAAM,aAAa;WACjB,OAAO;YACN,OAAO,EAAE;cACP,OAAO,EAAE;EACP,CAAC;AAGf,eAAO,MAAM,aAAa,0BAAuC,CAAC;AAElE;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EACrC,OAAO,SAAO,EACd,GAAG,SAAI,GACN,eAAe,CAAC,CAAC,CAAC,CAEpB"}

package/dist/utils/cache.js

@@ -0,0 +1,192 @@
+/**
+ * Validation Cache
+ *
+ * Caches validation results to avoid redundant computations.
+ * Uses LRU eviction to bound memory usage.
+ */
+/**
+ * Validation cache with LRU eviction
+ */
+export class ValidationCache {
+    cache = new Map();
+    hits = 0;
+    misses = 0;
+    maxSize;
+    ttl;
+    /**
+     * Create a validation cache
+     * @param maxSize Maximum number of entries
+     * @param ttl Time-to-live in milliseconds (0 = no expiration)
+     */
+    constructor(maxSize = 1000, ttl = 0) {
+        this.maxSize = maxSize;
+        this.ttl = ttl;
+    }
+    /**
+     * Generate cache key from input
+     */
+    generateKey(input) {
+        if (typeof input === 'string') {
+            return input;
+        }
+        return JSON.stringify(input);
+    }
+    /**
+     * Check if entry is expired
+     */
+    isExpired(entry) {
+        if (this.ttl === 0)
+            return false;
+        return Date.now() - entry.timestamp > this.ttl;
+    }
+    /**
+     * Evict least recently used entries
+     */
+    evictLRU() {
+        if (this.cache.size < this.maxSize)
+            return;
+        // Find entry with lowest hit count (simplified LRU)
+        let minHits = Infinity;
+        let minKey = null;
+        for (const [key, entry] of this.cache) {
+            if (entry.hits < minHits) {
+                minHits = entry.hits;
+                minKey = key;
+            }
+        }
+        if (minKey) {
+            this.cache.delete(minKey);
+        }
+    }
+    /**
+     * Get a cached value
+     */
+    get(input) {
+        const key = this.generateKey(input);
+        const entry = this.cache.get(key);
+        if (!entry) {
+            this.misses++;
+            return undefined;
+        }
+        if (this.isExpired(entry)) {
+            this.cache.delete(key);
+            this.misses++;
+            return undefined;
+        }
+        this.hits++;
+        entry.hits++;
+        return entry.value;
+    }
+    /**
+     * Set a cached value
+     */
+    set(input, value) {
+        const key = this.generateKey(input);
+        // Evict if at capacity
+        if (!this.cache.has(key)) {
+            this.evictLRU();
+        }
+        this.cache.set(key, {
+            value,
+            timestamp: Date.now(),
+            hits: 1,
+        });
+    }
+    /**
+     * Get or compute a value
+     */
+    getOrCompute(input, compute) {
+        const cached = this.get(input);
+        if (cached !== undefined) {
+            return cached;
+        }
+        const value = compute();
+        this.set(input, value);
+        return value;
+    }
+    /**
+     * Get or compute a value (async)
+     */
+    async getOrComputeAsync(input, compute) {
+        const cached = this.get(input);
+        if (cached !== undefined) {
+            return cached;
+        }
+        const value = await compute();
+        this.set(input, value);
+        return value;
+    }
+    /**
+     * Check if key exists
+     */
+    has(input) {
+        const key = this.generateKey(input);
+        const entry = this.cache.get(key);
+        if (!entry)
+            return false;
+        if (this.isExpired(entry)) {
+            this.cache.delete(key);
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Delete a cached value
+     */
+    delete(input) {
+        const key = this.generateKey(input);
+        return this.cache.delete(key);
+    }
+    /**
+     * Clear all cached values
+     */
+    clear() {
+        this.cache.clear();
+        this.hits = 0;
+        this.misses = 0;
+    }
+    /**
+     * Get cache statistics
+     */
+    getStats() {
+        const total = this.hits + this.misses;
+        return {
+            hits: this.hits,
+            misses: this.misses,
+            size: this.cache.size,
+            maxSize: this.maxSize,
+            hitRate: total > 0 ? this.hits / total : 0,
+        };
+    }
+    /**
+     * Remove expired entries
+     */
+    cleanup() {
+        if (this.ttl === 0)
+            return 0;
+        let removed = 0;
+        for (const [key, entry] of this.cache) {
+            if (this.isExpired(entry)) {
+                this.cache.delete(key);
+                removed++;
+            }
+        }
+        return removed;
+    }
+}
+/**
+ * Pre-configured caches for common use cases
+ */
+// Expression validation cache (expressions don't change often)
+export const expressionCache = new ValidationCache(500, 0);
+// Document validation cache (shorter TTL as documents may be modified)
+export const documentCache = new ValidationCache(100, 60000); // 1 minute TTL
+// Template cache (templates are static)
+export const templateCache = new ValidationCache(200, 0);
+/**
+ * Create a validation cache with custom configuration
+ */
+export function createValidationCache(maxSize = 1000, ttl = 0) {
+    return new ValidationCache(maxSize, ttl);
+}
+//# sourceMappingURL=cache.js.map