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

package/dist/config/ConfigResolver.js

@@ -0,0 +1,282 @@
+/**
+ * Configuration Resolver
+ *
+ * Resolves configuration from multiple sources with clear precedence:
+ * 1. Code (explicit parameters) - Highest priority
+ * 2. Environment variables
+ * 3. Configuration file (agent.json)
+ * 4. Defaults - Lowest priority
+ *
+ * @module config/ConfigResolver
+ */
+import { KadiError, ErrorCode } from '../types/index.js';
+import { ConfigLoader } from './ConfigLoader.js';
+/**
+ * Default configuration values
+ */
+const DEFAULT_CONFIG = {
+    version: '1.0.0',
+    role: 'agent',
+    transport: 'native',
+    networks: ['global'],
+    autoConnect: false,
+    advanced: {
+        heartbeatInterval: 30000,
+        requestTimeout: 30000,
+        connectionTimeout: 10000,
+        autoReconnect: true,
+        maxReconnectAttempts: 5,
+        verbose: false
+    }
+};
+/**
+ * Configuration Resolver
+ *
+ * Handles merging configuration from multiple sources with well-defined precedence.
+ * Makes configuration predictable and debuggable.
+ *
+ * @example
+ * ```typescript
+ * const resolver = new ConfigResolver();
+ *
+ * // Simple string config
+ * const config = await resolver.resolve('ws://localhost:8080');
+ *
+ * // Full config object
+ * const config = await resolver.resolve({
+ *   name: 'my-service',
+ *   brokers: { local: 'ws://localhost:8080' }
+ * });
+ * ```
+ */
+export class ConfigResolver {
+    loader;
+    /**
+     * Create a new ConfigResolver
+     *
+     * @param loader - Optional custom config loader (for testing)
+     */
+    constructor(loader) {
+        this.loader = loader ?? new ConfigLoader();
+    }
+    /**
+     * Resolve complete configuration from multiple sources
+     *
+     * Precedence (highest to lowest):
+     * 1. Explicit code configuration
+     * 2. Environment variables
+     * 3. Configuration file (agent.json)
+     * 4. Default values
+     *
+     * @param config - Configuration string (broker URL) or object
+     * @returns Fully resolved configuration with sources tracked
+     *
+     * @throws {KadiError} If configuration is invalid
+     *
+     * @example
+     * ```typescript
+     * // Simple broker URL
+     * const resolved = await resolver.resolve('ws://localhost:8080');
+     *
+     * // Full configuration
+     * const resolved = await resolver.resolve({
+     *   name: 'calculator',
+     *   brokers: { local: 'ws://localhost:8080' },
+     *   networks: ['global', 'team']
+     * });
+     * ```
+     */
+    async resolve(config) {
+        // Normalize input to object form
+        const codeConfig = this.normalizeConfig(config);
+        // Load configuration from file
+        const fileConfig = await this.loader.loadFromFile();
+        // Load configuration from environment
+        const envConfig = this.loader.loadFromEnvironment();
+        // Track sources for each field
+        const sources = {};
+        // Resolve each field with precedence
+        const resolved = {
+            name: this.resolveField('name', codeConfig.name, envConfig.KADI_AGENT_NAME, fileConfig?.name, undefined, sources),
+            version: this.resolveField('version', codeConfig.version, undefined, fileConfig?.version, DEFAULT_CONFIG.version, sources),
+            description: this.resolveField('description', codeConfig.description, undefined, fileConfig?.description, undefined, sources),
+            role: this.resolveField('role', codeConfig.role, undefined, undefined, DEFAULT_CONFIG.role, sources),
+            transport: this.resolveField('transport', codeConfig.transport, envConfig.KADI_TRANSPORT, undefined, DEFAULT_CONFIG.transport, sources),
+            brokers: this.resolveBrokers(codeConfig, envConfig, fileConfig, sources) ?? {},
+            defaultBroker: this.resolveField('defaultBroker', codeConfig.defaultBroker, undefined, fileConfig?.defaultBroker, undefined, sources),
+            networks: this.resolveNetworks(codeConfig, envConfig, fileConfig, sources),
+            abilityAgentJSON: this.resolveField('abilityAgentJSON', codeConfig.abilityAgentJSON, undefined, undefined, undefined, sources),
+            autoConnect: this.resolveField('autoConnect', codeConfig.autoConnect, this.parseBoolean(envConfig.KADI_AUTO_CONNECT), undefined, DEFAULT_CONFIG.autoConnect, sources),
+            advanced: this.resolveAdvanced(codeConfig, sources),
+            sources
+        };
+        // Validate resolved configuration
+        this.validateConfig(resolved);
+        return resolved;
+    }
+    /**
+     * Normalize configuration input
+     *
+     * Converts string (broker URL) to object form
+     *
+     * @param config - Configuration input
+     * @returns Normalized configuration object
+     */
+    normalizeConfig(config) {
+        if (typeof config === 'string') {
+            // Simple broker URL
+            return {
+                brokers: { default: config },
+                defaultBroker: 'default'
+            };
+        }
+        return config;
+    }
+    /**
+     * Resolve a single field with precedence
+     *
+     * @template T - Field value type
+     * @param fieldName - Name of the field being resolved
+     * @param codeValue - Value from code
+     * @param envValue - Value from environment
+     * @param fileValue - Value from file
+     * @param defaultValue - Default value
+     * @param sources - Source tracking object
+     * @returns Resolved value
+     */
+    resolveField(fieldName, codeValue, envValue, fileValue, defaultValue, sources) {
+        if (codeValue !== undefined) {
+            sources[fieldName] = 'code';
+            return codeValue;
+        }
+        if (envValue !== undefined) {
+            sources[fieldName] = 'environment';
+            return envValue;
+        }
+        if (fileValue !== undefined) {
+            sources[fieldName] = 'file';
+            return fileValue;
+        }
+        if (defaultValue !== undefined) {
+            sources[fieldName] = 'default';
+            return defaultValue;
+        }
+        throw new KadiError(`Required configuration field '${fieldName}' is missing`, ErrorCode.INVALID_CONFIG, 400, { fieldName });
+    }
+    /**
+     * Resolve broker configuration
+     *
+     * @param codeConfig - Code configuration
+     * @param envConfig - Environment configuration
+     * @param fileConfig - File configuration
+     * @param sources - Source tracking
+     * @returns Resolved brokers
+     */
+    resolveBrokers(codeConfig, envConfig, fileConfig, sources) {
+        if (codeConfig.brokers && Object.keys(codeConfig.brokers).length > 0) {
+            sources.brokers = 'code';
+            return codeConfig.brokers;
+        }
+        if (envConfig.KADI_BROKER_URL) {
+            sources.brokers = 'environment';
+            return { default: envConfig.KADI_BROKER_URL };
+        }
+        if (fileConfig?.brokers && Object.keys(fileConfig.brokers).length > 0) {
+            sources.brokers = 'file';
+            return fileConfig.brokers;
+        }
+        // Brokers are optional - may use native/stdio transport
+        return undefined;
+    }
+    /**
+     * Resolve networks configuration
+     *
+     * @param codeConfig - Code configuration
+     * @param envConfig - Environment configuration
+     * @param fileConfig - File configuration
+     * @param sources - Source tracking
+     * @returns Resolved networks
+     */
+    resolveNetworks(codeConfig, envConfig, fileConfig, sources) {
+        if (codeConfig.networks && codeConfig.networks.length > 0) {
+            sources.networks = 'code';
+            return codeConfig.networks;
+        }
+        if (envConfig.KADI_NETWORKS) {
+            sources.networks = 'environment';
+            return envConfig.KADI_NETWORKS.split(',').map(n => n.trim());
+        }
+        if (fileConfig?.networks && fileConfig.networks.length > 0) {
+            sources.networks = 'file';
+            return fileConfig.networks;
+        }
+        sources.networks = 'default';
+        return [...DEFAULT_CONFIG.networks];
+    }
+    /**
+     * Resolve advanced configuration
+     *
+     * @param codeConfig - Code configuration
+     * @param sources - Source tracking
+     * @returns Resolved advanced config
+     */
+    resolveAdvanced(codeConfig, sources) {
+        const advanced = {
+            ...DEFAULT_CONFIG.advanced,
+            ...codeConfig.advanced
+        };
+        sources.advanced = codeConfig.advanced ? 'code' : 'default';
+        return advanced;
+    }
+    /**
+     * Validate resolved configuration
+     *
+     * @param config - Resolved configuration
+     * @throws {KadiError} If configuration is invalid
+     */
+    validateConfig(config) {
+        // Validate name
+        if (!config.name || config.name.trim().length === 0) {
+            throw new KadiError('Agent name is required', ErrorCode.INVALID_CONFIG, 400, { field: 'name' });
+        }
+        // Validate transport
+        const validTransports = ['native', 'stdio', 'broker'];
+        if (!validTransports.includes(config.transport)) {
+            throw new KadiError(`Invalid transport: ${config.transport}. Must be one of: ${validTransports.join(', ')}`, ErrorCode.INVALID_CONFIG, 400, { field: 'transport', value: config.transport });
+        }
+        // Validate broker configuration if using broker transport
+        if (config.transport === 'broker') {
+            if (!config.brokers || Object.keys(config.brokers).length === 0) {
+                throw new KadiError('Broker configuration is required when using broker transport', ErrorCode.INVALID_CONFIG, 400, { field: 'brokers', transport: config.transport });
+            }
+            // Validate default broker exists if specified
+            if (config.defaultBroker && !config.brokers[config.defaultBroker]) {
+                throw new KadiError(`Default broker '${config.defaultBroker}' not found in broker configuration`, ErrorCode.INVALID_CONFIG, 400, { field: 'defaultBroker', value: config.defaultBroker, availableBrokers: Object.keys(config.brokers) });
+            }
+        }
+        // Validate networks
+        if (!Array.isArray(config.networks) || config.networks.length === 0) {
+            throw new KadiError('At least one network is required', ErrorCode.INVALID_CONFIG, 400, { field: 'networks' });
+        }
+    }
+    /**
+     * Parse boolean from string
+     *
+     * @param value - String value
+     * @returns Boolean or undefined
+     */
+    parseBoolean(value) {
+        if (value === undefined) {
+            return undefined;
+        }
+        const lower = value.toLowerCase();
+        if (lower === 'true' || lower === '1' || lower === 'yes') {
+            return true;
+        }
+        if (lower === 'false' || lower === '0' || lower === 'no') {
+            return false;
+        }
+        return undefined;
+    }
+}
+//# sourceMappingURL=ConfigResolver.js.map

package/dist/config/ConfigResolver.js.map

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

package/dist/config/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Configuration Module
+ *
+ * Exports for configuration resolution and loading.
+ */
+export { ConfigResolver } from './ConfigResolver.js';
+export { ConfigLoader } from './ConfigLoader.js';
+//# 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;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/config/index.js

@@ -0,0 +1,8 @@
+/**
+ * Configuration Module
+ *
+ * Exports for configuration resolution and loading.
+ */
+export { ConfigResolver } from './ConfigResolver.js';
+export { ConfigLoader } from './ConfigLoader.js';
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/errors/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Errors Module
+ *
+ * Re-exports error types and utilities from types/errors.ts
+ * This module provides a convenient import point for error handling.
+ */
+export { KadiError, ErrorCode, isKadiError, isError, success, failure } from '../types/errors.js';
+export type { ErrorContext, ErrorJSON, Result } from '../types/errors.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,SAAS,EACT,SAAS,EACT,WAAW,EACX,OAAO,EACP,OAAO,EACP,OAAO,EACR,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EACV,YAAY,EACZ,SAAS,EACT,MAAM,EACP,MAAM,oBAAoB,CAAC"}

package/dist/errors/index.js

@@ -0,0 +1,8 @@
+/**
+ * Errors Module
+ *
+ * Re-exports error types and utilities from types/errors.ts
+ * This module provides a convenient import point for error handling.
+ */
+export { KadiError, ErrorCode, isKadiError, isError, success, failure } from '../types/errors.js';
+//# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,SAAS,EACT,SAAS,EACT,WAAW,EACX,OAAO,EACP,OAAO,EACP,OAAO,EACR,MAAM,oBAAoB,CAAC"}

package/dist/events/EventHub.d.ts

@@ -0,0 +1,172 @@
+/**
+ * Event Hub
+ *
+ * Unified pub/sub event system that works consistently across all transports.
+ * Supports wildcard pattern matching for flexible event subscriptions.
+ *
+ * @module events/EventHub
+ */
+import type { EventPattern, EventName, EventCallback, UnsubscribeFunction, PublishOptions, EventSubscription, SubscriptionOptions } from '../types/index.js';
+/**
+ * Event Hub class
+ *
+ * Single responsibility: Manage event subscriptions and publication.
+ * Works uniformly across all transport types (native, stdio, broker).
+ *
+ * @example
+ * ```typescript
+ * const hub = new EventHub('my-agent');
+ *
+ * // Subscribe to events
+ * const unsubscribe = hub.subscribe('user.*', (data) => {
+ *   console.log('User event:', data);
+ * });
+ *
+ * // Publish an event
+ * hub.publish('user.login', { userId: '123', timestamp: Date.now() });
+ *
+ * // Unsubscribe
+ * unsubscribe();
+ * ```
+ */
+export declare class EventHub {
+    /**
+     * Source identifier (agent/ability name)
+     */
+    private source;
+    /**
+     * Event subscriptions map (pattern -> Set of callbacks)
+     * Uses unknown for data type since different subscriptions may have different data types
+     */
+    private readonly subscriptions;
+    /**
+     * Subscription ID counter
+     */
+    private subscriptionIdCounter;
+    /**
+     * Create a new EventHub
+     *
+     * @param source - Identifier for this event source (agent/ability name)
+     */
+    constructor(source: string);
+    /**
+     * Update the source identifier
+     *
+     * This is useful when the agent/ability name is determined after construction.
+     *
+     * @param newSource - New source identifier
+     */
+    setSource(newSource: string): void;
+    /**
+     * Subscribe to events matching a pattern
+     *
+     * Patterns support wildcards:
+     * - `user.login` - exact match
+     * - `user.*` - all events starting with "user."
+     * - `*.error` - all error events
+     * - `*` - all events
+     *
+     * @template TData - Expected event data type
+     *
+     * @param pattern - Event pattern to match
+     * @param callback - Function to call when matching events occur
+     * @param options - Optional subscription options
+     * @returns Function to unsubscribe
+     *
+     * @throws {KadiError} If pattern or callback is invalid
+     *
+     * @example
+     * ```typescript
+     * const unsubscribe = hub.subscribe('user.login', (data) => {
+     *   console.log('User logged in:', data);
+     * });
+     * ```
+     */
+    subscribe<TData = unknown>(pattern: EventPattern, callback: EventCallback<TData>, options?: SubscriptionOptions): UnsubscribeFunction;
+    /**
+     * Publish an event to all matching subscribers
+     *
+     * @template TData - Event data type
+     *
+     * @param eventName - Event name/channel
+     * @param data - Event data payload
+     * @param options - Optional publishing options
+     *
+     * @example
+     * ```typescript
+     * hub.publish('user.logout', {
+     *   userId: '123',
+     *   timestamp: Date.now()
+     * });
+     * ```
+     */
+    publish<TData = unknown>(eventName: EventName, data: TData, options?: PublishOptions): void;
+    /**
+     * Unsubscribe from a pattern
+     *
+     * @param pattern - Pattern to unsubscribe from
+     * @param callback - Optional specific callback to remove (removes all if not specified)
+     *
+     * @example
+     * ```typescript
+     * hub.unsubscribe('user.*');
+     * ```
+     */
+    unsubscribe(pattern: EventPattern, callback?: EventCallback): void;
+    /**
+     * Get all active subscriptions
+     *
+     * @returns Array of all active subscriptions
+     */
+    getSubscriptions(): EventSubscription[];
+    /**
+     * Get subscription count
+     *
+     * @returns Number of active subscriptions
+     */
+    get subscriptionCount(): number;
+    /**
+     * Clear all subscriptions
+     *
+     * @example
+     * ```typescript
+     * hub.clear();
+     * ```
+     */
+    clear(): void;
+    /**
+     * Find subscriptions matching an event name
+     *
+     * @param eventName - Event name to match
+     * @returns Set of matching subscriptions
+     */
+    private findMatchingSubscriptions;
+    /**
+     * Check if an event name matches a pattern
+     *
+     * Supports wildcard matching:
+     * - Exact match: 'user.login' matches 'user.login'
+     * - Prefix wildcard: 'user.*' matches 'user.login', 'user.logout', etc.
+     * - Suffix wildcard: '*.error' matches 'user.error', 'system.error', etc.
+     * - Full wildcard: '*' matches any event
+     *
+     * @param eventName - Event name to test
+     * @param pattern - Pattern to match against
+     * @returns true if event matches pattern
+     */
+    private matchesPattern;
+    /**
+     * Deliver an event to a subscription
+     *
+     * @param subscription - Subscription to deliver to
+     * @param payload - Event payload
+     */
+    private deliverEvent;
+    /**
+     * Unsubscribe by subscription ID
+     *
+     * @param id - Subscription ID to remove
+     */
+    private unsubscribeById;
+}
+//# sourceMappingURL=EventHub.d.ts.map

package/dist/events/EventHub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventHub.d.ts","sourceRoot":"","sources":["../../src/events/EventHub.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,SAAS,EACT,aAAa,EAEb,mBAAmB,EACnB,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACpB,MAAM,mBAAmB,CAAC;AAG3B;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,QAAQ;IACnB;;OAEG;IACH,OAAO,CAAC,MAAM,CAAS;IAEvB;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA4D;IAE1F;;OAEG;IACH,OAAO,CAAC,qBAAqB,CAAK;IAElC;;;;OAIG;gBACS,MAAM,EAAE,MAAM;IAI1B;;;;;;OAMG;IACH,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAIlC;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,SAAS,CAAC,KAAK,GAAG,OAAO,EACvB,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,aAAa,CAAC,KAAK,CAAC,EAC9B,OAAO,CAAC,EAAE,mBAAmB,GAC5B,mBAAmB;IA2DtB;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CAAC,KAAK,GAAG,OAAO,EACrB,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,KAAK,EACX,OAAO,CAAC,EAAE,cAAc,GACvB,IAAI;IAsBP;;;;;;;;;;OAUG;IACH,WAAW,CAAC,OAAO,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE,aAAa,GAAG,IAAI;IAwBlE;;;;OAIG;IACH,gBAAgB,IAAI,iBAAiB,EAAE;IAQvC;;;;OAIG;IACH,IAAI,iBAAiB,IAAI,MAAM,CAM9B;IAED;;;;;;;OAOG;IACH,KAAK,IAAI,IAAI;IAIb;;;;;OAKG;IACH,OAAO,CAAC,yBAAyB;IAcjC;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,cAAc;IAoBtB;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IA+BpB;;;;OAIG;IACH,OAAO,CAAC,eAAe;CAaxB"}