@kadi.build/core 0.0.1-alpha.1 → 0.0.1-alpha.10

package/dist/validation/SchemaValidator.js

@@ -0,0 +1,411 @@
+/**
+ * Schema Validator
+ * =================
+ *
+ * Validates tool input/output against MCP JSON Schemas using AJV.
+ * Implements global caching for performance at scale.
+ *
+ * **Performance Optimization**:
+ * - Global cache prevents redundant schema compilations
+ * - At scale (1000+ tools), this provides 1000x performance improvement
+ * - Memory efficient: ~5KB per compiled schema vs 5MB for duplicates
+ *
+ * @module validation/SchemaValidator
+ */
+import AjvDefault from 'ajv';
+import addFormatsDefault from 'ajv-formats';
+import { KadiError, ErrorCode } from '../types/index.js';
+/**
+ * ESM/CommonJS Interop for AJV
+ *
+ * TypeScript's NodeNext module resolution has issues with AJV's dual CJS/ESM exports.
+ * These casts ensure we get the correct constructor and function types regardless
+ * of how the modules are loaded at runtime.
+ *
+ * Without these, we get:
+ * - "This expression is not constructable" for `new Ajv()`
+ * - "This expression is not callable" for `addFormats()`
+ *
+ * This is a known TypeScript/Node.js ESM limitation, not a code smell.
+ */
+const AjvConstructor = AjvDefault;
+const addFormats = addFormatsDefault;
+/**
+ * Global Schema Compilation Cache
+ * =================================
+ *
+ * **Why Global?**
+ * At scale (1000+ agents, 10 tools each), the same schemas are compiled repeatedly.
+ * Without caching: 10,000 compilations of the same ~10 unique schemas.
+ * With caching: 10 compilations (1000x improvement).
+ *
+ * **Performance**:
+ * - Memory: 50KB (cached) vs 50MB (duplicates)
+ * - CPU: O(1) cache lookup vs O(n) compilation
+ *
+ * **Thread Safety**:
+ * Node.js is single-threaded, no locking needed.
+ *
+ * **Singleton Pattern**:
+ * Ensures one cache instance across entire application.
+ */
+class GlobalSchemaCache {
+    static instance;
+    cache = new Map();
+    ajv;
+    constructor() {
+        // Shared AJV instance for all schema compilations
+        this.ajv = new AjvConstructor({
+            allErrors: true, // Collect all errors, not just first
+            verbose: true, // Include validated data in errors
+            strict: false, // Allow unknown JSON Schema keywords
+            validateFormats: true // Validate format constraints
+        });
+        // Add format validators (email, uri, date, etc.)
+        addFormats(this.ajv);
+    }
+    /**
+     * Get the singleton cache instance
+     *
+     * @returns Global schema cache
+     */
+    static getInstance() {
+        if (!GlobalSchemaCache.instance) {
+            GlobalSchemaCache.instance = new GlobalSchemaCache();
+        }
+        return GlobalSchemaCache.instance;
+    }
+    /**
+     * Get or compile a schema validator
+     *
+     * **Cache Strategy**:
+     * - Cache key: JSON.stringify(schema)
+     * - Hit: Return cached validator (O(1))
+     * - Miss: Compile and cache for future use (O(n))
+     *
+     * @param schema - JSON Schema to compile
+     * @returns Compiled validator function
+     * @throws {Error} If schema compilation fails
+     */
+    getValidator(schema) {
+        // Generate cache key from schema content
+        const cacheKey = JSON.stringify(schema);
+        // Check cache first
+        let validator = this.cache.get(cacheKey);
+        if (!validator) {
+            // Cache miss - compile and store
+            validator = this.ajv.compile(schema);
+            this.cache.set(cacheKey, validator);
+        }
+        return validator;
+    }
+    /**
+     * Get cache statistics
+     *
+     * Useful for monitoring and debugging.
+     *
+     * @returns Cache statistics
+     */
+    getStats() {
+        return {
+            cachedSchemas: this.cache.size
+        };
+    }
+    /**
+     * Clear the global cache
+     *
+     * Primarily for testing. In production, cache should persist
+     * for lifetime of application.
+     */
+    clear() {
+        this.cache.clear();
+    }
+}
+/**
+ * Schema Validator
+ * =================
+ *
+ * Validates tool inputs and outputs against JSON Schemas.
+ * Each instance manages schemas for a set of tools, but shares
+ * the global compilation cache for efficiency.
+ *
+ * **Usage**:
+ * ```typescript
+ * const validator = new SchemaValidator();
+ *
+ * // Register tool schemas
+ * validator.registerTool('add', inputSchema, outputSchema);
+ *
+ * // Validate input
+ * const result = validator.validateInput('add', { a: 5, b: 3 });
+ * if (!result.valid) {
+ *   console.error('Validation failed:', result.errors);
+ * }
+ * ```
+ */
+export class SchemaValidator {
+    /**
+     * Tool schemas (per validator instance)
+     */
+    toolSchemas = new Map();
+    /**
+     * Compiled validators (per validator instance, but reuses global cache)
+     */
+    validators = new Map();
+    /**
+     * Reference to global cache (shared across all instances)
+     */
+    globalCache;
+    constructor() {
+        // Get singleton cache instance (shared with all SchemaValidator instances)
+        this.globalCache = GlobalSchemaCache.getInstance();
+    }
+    /**
+     * Register a tool with its input and output schemas
+     *
+     * Compiles schemas using global cache to avoid redundant work.
+     * If these schemas were compiled before (by any validator instance),
+     * the cached validators are reused.
+     *
+     * @param toolName - Tool name
+     * @param inputSchema - Input JSON Schema (MCP format)
+     * @param outputSchema - Optional output JSON Schema (MCP format)
+     * @throws {KadiError} If schema compilation fails
+     *
+     * @example
+     * ```typescript
+     * validator.registerTool('add', {
+     *   type: 'object',
+     *   properties: {
+     *     a: { type: 'number' },
+     *     b: { type: 'number' }
+     *   },
+     *   required: ['a', 'b']
+     * }, {
+     *   type: 'object',
+     *   properties: {
+     *     result: { type: 'number' }
+     *   }
+     * });
+     * ```
+     */
+    registerTool(toolName, inputSchema, outputSchema) {
+        try {
+            // Get or compile validators using global cache
+            const inputValidator = this.globalCache.getValidator(inputSchema);
+            const outputValidator = outputSchema
+                ? this.globalCache.getValidator(outputSchema)
+                : undefined;
+            // Store schemas and validators for this tool
+            this.toolSchemas.set(toolName, { input: inputSchema, output: outputSchema });
+            this.validators.set(toolName, { input: inputValidator, output: outputValidator });
+        }
+        catch (error) {
+            throw new KadiError(`Failed to compile schemas for tool '${toolName}': ${error instanceof Error ? error.message : String(error)}`, ErrorCode.SCHEMA_VALIDATION_FAILED, 400, { toolName, error });
+        }
+    }
+    /**
+     * Validate input data against a tool's input schema
+     *
+     * @param toolName - Tool name
+     * @param input - Input data to validate
+     * @returns Validation result
+     *
+     * @example
+     * ```typescript
+     * const result = validator.validateInput('add', { a: 5, b: 3 });
+     * if (!result.valid) {
+     *   console.error('Invalid input:', result.errors);
+     * }
+     * ```
+     */
+    validateInput(toolName, input) {
+        const validators = this.validators.get(toolName);
+        if (!validators) {
+            return {
+                valid: false,
+                errors: [`No schema registered for tool '${toolName}'`]
+            };
+        }
+        const valid = validators.input(input);
+        if (valid) {
+            return { valid: true, errors: [] };
+        }
+        const errors = this.formatValidationErrors(validators.input.errors || []);
+        return {
+            valid: false,
+            errors,
+            errorDetails: validators.input.errors || []
+        };
+    }
+    /**
+     * Validate output data against a tool's output schema
+     *
+     * @param toolName - Tool name
+     * @param output - Output data to validate
+     * @returns Validation result
+     *
+     * @example
+     * ```typescript
+     * const result = validator.validateOutput('add', { result: 8 });
+     * if (!result.valid) {
+     *   console.error('Invalid output:', result.errors);
+     * }
+     * ```
+     */
+    validateOutput(toolName, output) {
+        const validators = this.validators.get(toolName);
+        if (!validators) {
+            return {
+                valid: false,
+                errors: [`No schema registered for tool '${toolName}'`]
+            };
+        }
+        // Output schema is optional in MCP
+        if (!validators.output) {
+            return { valid: true, errors: [] };
+        }
+        const valid = validators.output(output);
+        if (valid) {
+            return { valid: true, errors: [] };
+        }
+        const errors = this.formatValidationErrors(validators.output.errors || []);
+        return {
+            valid: false,
+            errors,
+            errorDetails: validators.output.errors || []
+        };
+    }
+    /**
+     * Get the schemas for a tool
+     *
+     * @param toolName - Tool name
+     * @returns Tool schemas or undefined if not registered
+     */
+    getToolSchemas(toolName) {
+        return this.toolSchemas.get(toolName);
+    }
+    /**
+     * Check if a tool has registered schemas
+     *
+     * @param toolName - Tool name
+     * @returns Whether tool is registered
+     */
+    hasToolSchemas(toolName) {
+        return this.toolSchemas.has(toolName);
+    }
+    /**
+     * Remove schemas for a tool
+     *
+     * @param toolName - Tool name
+     */
+    unregisterTool(toolName) {
+        this.toolSchemas.delete(toolName);
+        this.validators.delete(toolName);
+    }
+    /**
+     * Get all registered tool names
+     *
+     * @returns Array of tool names
+     */
+    getRegisteredTools() {
+        return Array.from(this.toolSchemas.keys());
+    }
+    /**
+     * Validate a schema definition itself (meta-validation)
+     *
+     * Checks if a schema is valid JSON Schema and can be compiled.
+     * Uses global cache to avoid redundant compilations.
+     *
+     * @param schema - JSON Schema to validate
+     * @returns Validation result
+     *
+     * @example
+     * ```typescript
+     * const result = validator.validateSchemaDefinition({
+     *   type: 'object',
+     *   properties: {
+     *     name: { type: 'string' }
+     *   }
+     * });
+     * if (!result.valid) {
+     *   console.error('Invalid schema:', result.errors);
+     * }
+     * ```
+     */
+    validateSchemaDefinition(schema) {
+        try {
+            // Attempt to compile using global cache
+            // This validates the schema and potentially caches it for future use
+            this.globalCache.getValidator(schema);
+            return { valid: true, errors: [] };
+        }
+        catch (error) {
+            return {
+                valid: false,
+                errors: [error instanceof Error ? error.message : String(error)]
+            };
+        }
+    }
+    /**
+     * Format validation errors for human readability
+     *
+     * Converts AJV error objects into clear, actionable error messages.
+     *
+     * @param errors - AJV error objects
+     * @returns Human-readable error messages
+     */
+    formatValidationErrors(errors) {
+        return errors.map((error) => {
+            const path = error.instancePath || '/';
+            const message = error.message || 'Validation failed';
+            // Specific formatting for common error types
+            if (error.keyword === 'required') {
+                return `Missing required field at ${path}: ${error.params.missingProperty}`;
+            }
+            if (error.keyword === 'type') {
+                const expected = error.params.type;
+                const actual = typeof error.data;
+                return `Invalid type at ${path}: expected ${expected}, got ${actual}`;
+            }
+            if (error.keyword === 'additionalProperties') {
+                return `Unexpected property at ${path}: ${error.params.additionalProperty}`;
+            }
+            if (error.keyword === 'enum') {
+                return `Invalid value at ${path}: must be one of ${error.params.allowedValues?.join(', ')}`;
+            }
+            if (error.keyword === 'minimum' || error.keyword === 'maximum') {
+                return `Value at ${path} ${message} (limit: ${error.params.limit})`;
+            }
+            if (error.keyword === 'minLength' || error.keyword === 'maxLength') {
+                return `String at ${path} ${message} (limit: ${error.params.limit})`;
+            }
+            if (error.keyword === 'pattern') {
+                return `String at ${path} does not match pattern: ${error.params.pattern}`;
+            }
+            if (error.keyword === 'format') {
+                return `Invalid ${error.params.format} format at ${path}`;
+            }
+            // Default formatting
+            return `${path}: ${message}`;
+        });
+    }
+    /**
+     * Get global cache statistics
+     *
+     * @returns Cache statistics
+     */
+    static getCacheStats() {
+        return GlobalSchemaCache.getInstance().getStats();
+    }
+    /**
+     * Clear global cache
+     *
+     * **Warning**: This affects all SchemaValidator instances.
+     * Primarily for testing.
+     */
+    static clearGlobalCache() {
+        GlobalSchemaCache.getInstance().clear();
+    }
+}
+//# sourceMappingURL=SchemaValidator.js.map

package/dist/validation/SchemaValidator.js.map

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

package/dist/validation/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Validation Module
+ * ==================
+ *
+ * Schema validation using AJV for MCP JSON Schemas.
+ *
+ * @module validation
+ */
+export { SchemaValidator } from './SchemaValidator.js';
+export type { ValidationResult } from './SchemaValidator.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validation/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/validation/index.js

@@ -0,0 +1,10 @@
+/**
+ * Validation Module
+ * ==================
+ *
+ * Schema validation using AJV for MCP JSON Schemas.
+ *
+ * @module validation
+ */
+export { SchemaValidator } from './SchemaValidator.js';
+//# sourceMappingURL=index.js.map

package/dist/validation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/validation/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}

package/package.json

@@ -1,12 +1,59 @@
 {
   "name": "@kadi.build/core",
-  "version": "0.0.1-alpha.1",
+  "version": "0.0.1-alpha.10",
   "description": "A module that is a comprehensive toolkit for developers integrating with the KADI infrastructure.",
-  "main": "index.js",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
   "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./types": {
+      "import": "./dist/types/index.js",
+      "types": "./dist/types/index.d.ts"
+    },
+    "./types/protocol": {
+      "import": "./dist/types/protocol.js",
+      "types": "./dist/types/protocol.d.ts"
+    },
+    "./messages": {
+      "import": "./dist/messages/index.js",
+      "types": "./dist/messages/index.d.ts"
+    },
+    "./schemas": {
+      "import": "./dist/schemas/index.js",
+      "types": "./dist/schemas/index.d.ts"
+    },
+    "./schemas/mcp": {
+      "import": "./dist/schemas/mcp/schema.js",
+      "types": "./dist/schemas/mcp/schema.d.ts"
+    },
+    "./validation": {
+      "import": "./dist/validation/index.js",
+      "types": "./dist/validation/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
   "scripts": {
+    "clean": "rm -rf dist",
+    "build": "npm run clean && tsc",
+    "build:watch": "tsc --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:ui": "vitest --ui",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint 'src/**/*.{js,ts}'",
+    "lint:fix": "eslint 'src/**/*.{js,ts}' --fix",
     "format": "prettier --write .",
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "format:check": "prettier --check .",
+    "prepublishOnly": "npm run build"
   },
   "author": "Corey Clark",
   "contributors": [
@@ -17,10 +64,27 @@
   ],
   "license": "MIT",
   "dependencies": {
+    "ajv": "^8.17.1",
+    "ajv-formats": "^3.0.1",
+    "chalk": "^5.5.0",
+    "debug": "^4.4.1",
     "events": "^3.3.0",
-    "ws": "^8.16.0"
+    "ws": "^8.16.0",
+    "zod": "^4.1.5"
   },
   "devDependencies": {
-    "prettier": "^3.6.2"
+    "@types/debug": "^4.1.12",
+    "@types/node": "^20.19.11",
+    "@types/ws": "^8.18.1",
+    "@typescript-eslint/eslint-plugin": "^7.18.0",
+    "@typescript-eslint/parser": "^7.18.0",
+    "@vitest/coverage-v8": "^3.2.4",
+    "@vitest/ui": "^3.2.4",
+    "eslint": "^8.57.1",
+    "eslint-config-prettier": "^9.1.2",
+    "eslint-plugin-prettier": "^5.5.4",
+    "prettier": "^3.6.2",
+    "typescript": "^5.9.2",
+    "vitest": "^3.2.4"
   }
 }

package/agent.json

@@ -1,18 +0,0 @@
-{
-  "name": "kadi-core",
-  "version": "0.0.1",
-  "license": "MIT",
-  "description": "base install ability for kadi",
-  "repo": "https://gitlab.com/humin-game-lab/agent-abilities/kadi-core.git",
-  "lib": "https://gitlab.com/humin-game-lab/agent-abilities/kadi-core/-/archive/v0.0.1/kadi-core-v0.0.1.zip",
-  "abilities": {},
-
-  "scripts": {
-    "preflight": "echo 'kadi-core v0.0.1 is starting...'",
-    "setup": "echo 'kadi-core v0.0.1 is ready...'",
-    "start": "npm install",
-    "stop": "echo 'kadi-core v0.0.1 is ready...'",
-    "python": "python3 ./node_modules/kadi-core/ipcInterfaces/pythonAbilityIPC.py",
-    "rust": "cargo run --bin path/to/rustAbilityIPC"
-  }
-}