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

package/dist/abilities/AbilityValidator.d.ts

@@ -0,0 +1,172 @@
+/**
+ * Ability Validator
+ *
+ * Runtime validation to ensure loaded abilities meet expectations.
+ * Catches mismatches early with clear, actionable error messages.
+ *
+ * @module abilities/AbilityValidator
+ */
+import type { LoadedAbility } from './AbilityProxy.js';
+/**
+ * Validation options
+ */
+export interface ValidationOptions {
+    /**
+     * Expected method names
+     *
+     * If provided, validator checks these methods exist.
+     */
+    expectedMethods?: string[];
+    /**
+     * Whether to require at least one method
+     *
+     * @default true
+     */
+    requireMethods?: boolean;
+    /**
+     * Allow additional methods beyond expected
+     *
+     * @default true
+     */
+    allowAdditional?: boolean;
+}
+/**
+ * Ability Validator
+ *
+ * Ensures loaded abilities are valid and meet expectations before
+ * returning them to developers.
+ *
+ * **Why Runtime Validation?**
+ *
+ * TypeScript provides compile-time types, but those can lie:
+ * ```typescript
+ * interface CalcAPI {
+ *   add(): Promise<number>;
+ * }
+ * const calc = await client.load<CalcAPI>('calculator');
+ * // TypeScript happy, but what if ability doesn't have add()?
+ * await calc.add(); // Runtime error!
+ * ```
+ *
+ * Runtime validation catches this early with helpful errors.
+ *
+ * @example
+ * ```typescript
+ * // Basic validation - just check ability has methods
+ * AbilityValidator.validate(ability);
+ *
+ * // Validate specific methods
+ * AbilityValidator.validate(ability, {
+ *   expectedMethods: ['add', 'subtract', 'multiply']
+ * });
+ * ```
+ */
+export declare class AbilityValidator {
+    /**
+     * Validate ability meets expectations
+     *
+     * Checks:
+     * 1. Ability is properly initialized
+     * 2. Ability has methods (not empty)
+     * 3. Expected methods exist (if specified)
+     *
+     * @param ability - Loaded ability to validate
+     * @param options - Validation options
+     *
+     * @throws {KadiError} If validation fails
+     *
+     * @example
+     * ```typescript
+     * // Basic validation
+     * AbilityValidator.validate(ability);
+     *
+     * // Validate has specific methods
+     * AbilityValidator.validate(ability, {
+     *   expectedMethods: ['process', 'analyze']
+     * });
+     * ```
+     */
+    static validate(ability: LoadedAbility, options?: ValidationOptions): void;
+    /**
+     * Validate expected methods exist
+     *
+     * Checks that all expected methods are present in ability.
+     * Optionally checks for unexpected extra methods.
+     *
+     * @param ability - Loaded ability
+     * @param expectedMethods - Methods that should exist
+     * @param availableMethods - Methods that actually exist
+     * @param allowAdditional - Whether to allow extra methods
+     *
+     * @throws {KadiError} If validation fails
+     */
+    private static validateExpectedMethods;
+    /**
+     * Suggest similar method names (typo detection)
+     *
+     * Uses simple string similarity to suggest corrections.
+     *
+     * @param missingMethods - Methods not found
+     * @param availableMethods - Methods that exist
+     * @returns Array of suggestions
+     *
+     * @example
+     * ```typescript
+     * suggestSimilarMethods(['proces'], ['process', 'analyze'])
+     * // Returns: ['process']  (close match)
+     * ```
+     */
+    private static suggestSimilarMethods;
+    /**
+     * Check if two strings are similar (typo detection)
+     *
+     * Simple heuristic: strings are similar if:
+     * - Length difference ≤ 2
+     * - Share at least 70% of characters
+     *
+     * @param str1 - First string
+     * @param str2 - Second string
+     * @returns true if similar
+     */
+    private static isSimilar;
+    /**
+     * Validate ability is connected
+     *
+     * Ensures ability transport is active before use.
+     *
+     * @param ability - Loaded ability
+     *
+     * @throws {KadiError} If not connected
+     *
+     * @example
+     * ```typescript
+     * AbilityValidator.validateConnected(ability);
+     * ```
+     */
+    static validateConnected(ability: LoadedAbility): void;
+    /**
+     * Extract method names from TypeScript interface type
+     *
+     * Helper to get expected methods from type definition.
+     * Uses TypeScript compiler API if available.
+     *
+     * This is a placeholder for future type-based validation.
+     *
+     * @template T - Interface type (marker for future implementation)
+     * @returns Array of method names
+     *
+     * @example
+     * ```typescript
+     * interface CalcAPI {
+     *   add(): Promise<number>;
+     *   subtract(): Promise<number>;
+     * }
+     *
+     * // Future: Extract methods from type
+     * const methods = AbilityValidator.extractMethodsFromType<CalcAPI>();
+     * // Would return: ['add', 'subtract']
+     * ```
+     */
+    static extractMethodsFromType<T>(): string[];
+}
+//# sourceMappingURL=AbilityValidator.d.ts.map

package/dist/abilities/AbilityValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AbilityValidator.d.ts","sourceRoot":"","sources":["../../src/abilities/AbilityValidator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGvD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAE3B;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBAAa,gBAAgB;IAC3B;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,MAAM,CAAC,QAAQ,CACb,OAAO,EAAE,aAAa,EACtB,OAAO,GAAE,iBAAsB,GAC9B,IAAI;IAkCP;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,MAAM,CAAC,uBAAuB;IAmEtC;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,MAAM,CAAC,qBAAqB;IAmBpC;;;;;;;;;;OAUG;IACH,OAAO,CAAC,MAAM,CAAC,SAAS;IAuBxB;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,iBAAiB,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI;IAiBtD;;;;;;;;;;;;;;;;;;;;;;OAsBG;IAEH,MAAM,CAAC,sBAAsB,CAAC,CAAC,KAAK,MAAM,EAAE;CAO7C"}

package/dist/abilities/AbilityValidator.js

@@ -0,0 +1,253 @@
+/**
+ * Ability Validator
+ *
+ * Runtime validation to ensure loaded abilities meet expectations.
+ * Catches mismatches early with clear, actionable error messages.
+ *
+ * @module abilities/AbilityValidator
+ */
+import { KadiError, ErrorCode } from '../types/index.js';
+/**
+ * Ability Validator
+ *
+ * Ensures loaded abilities are valid and meet expectations before
+ * returning them to developers.
+ *
+ * **Why Runtime Validation?**
+ *
+ * TypeScript provides compile-time types, but those can lie:
+ * ```typescript
+ * interface CalcAPI {
+ *   add(): Promise<number>;
+ * }
+ * const calc = await client.load<CalcAPI>('calculator');
+ * // TypeScript happy, but what if ability doesn't have add()?
+ * await calc.add(); // Runtime error!
+ * ```
+ *
+ * Runtime validation catches this early with helpful errors.
+ *
+ * @example
+ * ```typescript
+ * // Basic validation - just check ability has methods
+ * AbilityValidator.validate(ability);
+ *
+ * // Validate specific methods
+ * AbilityValidator.validate(ability, {
+ *   expectedMethods: ['add', 'subtract', 'multiply']
+ * });
+ * ```
+ */
+export class AbilityValidator {
+    /**
+     * Validate ability meets expectations
+     *
+     * Checks:
+     * 1. Ability is properly initialized
+     * 2. Ability has methods (not empty)
+     * 3. Expected methods exist (if specified)
+     *
+     * @param ability - Loaded ability to validate
+     * @param options - Validation options
+     *
+     * @throws {KadiError} If validation fails
+     *
+     * @example
+     * ```typescript
+     * // Basic validation
+     * AbilityValidator.validate(ability);
+     *
+     * // Validate has specific methods
+     * AbilityValidator.validate(ability, {
+     *   expectedMethods: ['process', 'analyze']
+     * });
+     * ```
+     */
+    static validate(ability, options = {}) {
+        // Step 1: Get available methods from ability
+        const availableMethods = ability.__getMethods();
+        const abilityName = ability.__name;
+        const transport = ability.__transport;
+        // Step 2: Check ability has at least one method (unless disabled)
+        const requireMethods = options.requireMethods ?? true;
+        if (requireMethods && availableMethods.length === 0) {
+            throw new KadiError(`Ability '${abilityName}' has no methods`, ErrorCode.ABILITY_INVALID, 500, {
+                abilityName,
+                transport,
+                reason: 'Ability initialized but exposes no methods',
+                suggestion: 'Check ability implementation exports methods correctly',
+                hint: 'Ability should implement and expose at least one method'
+            });
+        }
+        // Step 3: Validate expected methods if specified
+        if (options.expectedMethods && options.expectedMethods.length > 0) {
+            this.validateExpectedMethods(ability, options.expectedMethods, availableMethods, options.allowAdditional ?? true);
+        }
+    }
+    /**
+     * Validate expected methods exist
+     *
+     * Checks that all expected methods are present in ability.
+     * Optionally checks for unexpected extra methods.
+     *
+     * @param ability - Loaded ability
+     * @param expectedMethods - Methods that should exist
+     * @param availableMethods - Methods that actually exist
+     * @param allowAdditional - Whether to allow extra methods
+     *
+     * @throws {KadiError} If validation fails
+     */
+    static validateExpectedMethods(ability, expectedMethods, availableMethods, allowAdditional) {
+        const abilityName = ability.__name;
+        const transport = ability.__transport;
+        // Step 1: Find missing methods
+        const missingMethods = expectedMethods.filter(method => !availableMethods.includes(method));
+        // Step 2: Check if any methods missing
+        if (missingMethods.length > 0) {
+            // Generate helpful error message
+            const suggestions = this.suggestSimilarMethods(missingMethods, availableMethods);
+            throw new KadiError(`Ability '${abilityName}' missing expected methods: ${missingMethods.join(', ')}`, ErrorCode.ABILITY_INVALID, 500, {
+                abilityName,
+                transport,
+                missingMethods,
+                availableMethods,
+                expectedMethods,
+                reason: 'Ability does not implement all expected methods',
+                suggestion: suggestions.length > 0
+                    ? `Did you mean: ${suggestions.join(', ')}?`
+                    : `Available methods: ${availableMethods.join(', ')}`,
+                hint: 'Check ability version matches expected interface'
+            });
+        }
+        // Step 3: Check for unexpected methods (if strict mode)
+        if (!allowAdditional) {
+            const unexpectedMethods = availableMethods.filter(method => !expectedMethods.includes(method));
+            if (unexpectedMethods.length > 0) {
+                throw new KadiError(`Ability '${abilityName}' has unexpected methods: ${unexpectedMethods.join(', ')}`, ErrorCode.ABILITY_INVALID, 500, {
+                    abilityName,
+                    transport,
+                    unexpectedMethods,
+                    expectedMethods,
+                    availableMethods,
+                    reason: 'Ability implements methods not in expected interface',
+                    suggestion: 'Update expected interface or set allowAdditional: true',
+                    hint: 'Strict validation prevents interface drift'
+                });
+            }
+        }
+    }
+    /**
+     * Suggest similar method names (typo detection)
+     *
+     * Uses simple string similarity to suggest corrections.
+     *
+     * @param missingMethods - Methods not found
+     * @param availableMethods - Methods that exist
+     * @returns Array of suggestions
+     *
+     * @example
+     * ```typescript
+     * suggestSimilarMethods(['proces'], ['process', 'analyze'])
+     * // Returns: ['process']  (close match)
+     * ```
+     */
+    static suggestSimilarMethods(missingMethods, availableMethods) {
+        const suggestions = [];
+        // For each missing method, find similar available methods
+        for (const missing of missingMethods) {
+            for (const available of availableMethods) {
+                // Simple similarity check: Levenshtein distance
+                if (this.isSimilar(missing, available)) {
+                    suggestions.push(available);
+                }
+            }
+        }
+        return [...new Set(suggestions)]; // Remove duplicates
+    }
+    /**
+     * Check if two strings are similar (typo detection)
+     *
+     * Simple heuristic: strings are similar if:
+     * - Length difference ≤ 2
+     * - Share at least 70% of characters
+     *
+     * @param str1 - First string
+     * @param str2 - Second string
+     * @returns true if similar
+     */
+    static isSimilar(str1, str2) {
+        // Quick check: length difference
+        const lengthDiff = Math.abs(str1.length - str2.length);
+        if (lengthDiff > 2) {
+            return false;
+        }
+        // Count matching characters
+        const s1 = str1.toLowerCase();
+        const s2 = str2.toLowerCase();
+        let matches = 0;
+        for (let i = 0; i < Math.min(s1.length, s2.length); i++) {
+            if (s1[i] === s2[i]) {
+                matches++;
+            }
+        }
+        // Similar if >70% characters match
+        const similarity = matches / Math.max(s1.length, s2.length);
+        return similarity >= 0.7;
+    }
+    /**
+     * Validate ability is connected
+     *
+     * Ensures ability transport is active before use.
+     *
+     * @param ability - Loaded ability
+     *
+     * @throws {KadiError} If not connected
+     *
+     * @example
+     * ```typescript
+     * AbilityValidator.validateConnected(ability);
+     * ```
+     */
+    static validateConnected(ability) {
+        if (!ability.__isConnected()) {
+            throw new KadiError(`Ability '${ability.__name}' is not connected`, ErrorCode.ABILITY_NOT_CONNECTED, 503, {
+                abilityName: ability.__name,
+                transport: ability.__transport,
+                reason: 'Ability transport disconnected or never initialized',
+                suggestion: 'Reload ability: await client.load(...)',
+                hint: 'Check if ability was disconnected or connection lost'
+            });
+        }
+    }
+    /**
+     * Extract method names from TypeScript interface type
+     *
+     * Helper to get expected methods from type definition.
+     * Uses TypeScript compiler API if available.
+     *
+     * This is a placeholder for future type-based validation.
+     *
+     * @template T - Interface type (marker for future implementation)
+     * @returns Array of method names
+     *
+     * @example
+     * ```typescript
+     * interface CalcAPI {
+     *   add(): Promise<number>;
+     *   subtract(): Promise<number>;
+     * }
+     *
+     * // Future: Extract methods from type
+     * const methods = AbilityValidator.extractMethodsFromType<CalcAPI>();
+     * // Would return: ['add', 'subtract']
+     * ```
+     */
+    // @ts-expect-error - T is placeholder for future type introspection feature
+    static extractMethodsFromType() {
+        // TODO: Implement type introspection
+        // This would require TypeScript compiler API at runtime
+        // For now, developers must explicitly list expected methods
+        return [];
+    }
+}
+//# sourceMappingURL=AbilityValidator.js.map

package/dist/abilities/AbilityValidator.js.map

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

package/dist/abilities/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Abilities Module
+ *
+ * Complete ability loading system with excellent developer experience:
+ * - Explicit transport selection
+ * - Intelligent caching
+ * - Runtime validation
+ * - Type-safe options
+ *
+ * @example
+ * ```typescript
+ * import { AbilityLoader } from '@kadi.build/core/abilities';
+ *
+ * const loader = new AbilityLoader();
+ * const ability = await loader.load('calculator', 'broker', {}, brokerClient);
+ * ```
+ */
+export { AbilityLoader } from './AbilityLoader.js';
+export { AbilityProxy } from './AbilityProxy.js';
+export { AbilityCache } from './AbilityCache.js';
+export { AbilityValidator } from './AbilityValidator.js';
+export type { LoadedAbility, AbilityFramework, DynamicMethods, TransportType } from './AbilityProxy.js';
+export type { AgentJson, LoadOptions, BrokerLoadOptions, NativeLoadOptions, StdioLoadOptions, TransportType as LoadTransportType } from './types.js';
+export type { CacheKey } from './AbilityCache.js';
+export type { ValidationOptions } from './AbilityValidator.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/abilities/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAGzD,YAAY,EACV,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,aAAa,EACd,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,SAAS,EACT,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,IAAI,iBAAiB,EACnC,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,YAAY,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/abilities/index.js

@@ -0,0 +1,23 @@
+/**
+ * Abilities Module
+ *
+ * Complete ability loading system with excellent developer experience:
+ * - Explicit transport selection
+ * - Intelligent caching
+ * - Runtime validation
+ * - Type-safe options
+ *
+ * @example
+ * ```typescript
+ * import { AbilityLoader } from '@kadi.build/core/abilities';
+ *
+ * const loader = new AbilityLoader();
+ * const ability = await loader.load('calculator', 'broker', {}, brokerClient);
+ * ```
+ */
+// Core classes
+export { AbilityLoader } from './AbilityLoader.js';
+export { AbilityProxy } from './AbilityProxy.js';
+export { AbilityCache } from './AbilityCache.js';
+export { AbilityValidator } from './AbilityValidator.js';
+//# sourceMappingURL=index.js.map

package/dist/abilities/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/abilities/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,eAAe;AACf,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}