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

package/dist/client/KadiClient.js

@@ -0,0 +1,492 @@
+/**
+ * KADI Client
+ *
+ * Thin orchestrator that composes specialized modules to provide the
+ * complete KADI client functionality.
+ *
+ * This is dramatically simpler than the old implementation because each
+ * concern has been properly separated.
+ *
+ * @module client/KadiClient
+ */
+import { EventEmitter } from 'events';
+import { KadiError, ErrorCode } from '../types/index.js';
+import { KadiMessages } from '../messages/index.js';
+import { ConfigResolver } from '../config/ConfigResolver.js';
+import { ToolRegistry } from '../tools/ToolRegistry.js';
+import { EventHub } from '../events/EventHub.js';
+import { BrokerConnectionManager } from '../broker/BrokerConnectionManager.js';
+import { BrokerProtocol, PROTOCOL_VERSION } from '../broker/BrokerProtocol.js';
+import { AbilityLoader } from '../abilities/index.js';
+/**
+ * KADI Client
+ *
+ * Main client class for KADI framework.
+ * Orchestrates tool registry, event hub, broker connections, and ability loading.
+ *
+ * @example
+ * ```typescript
+ * // Create client
+ * const client = new KadiClient({
+ *   name: 'my-service',
+ *   brokers: { local: 'ws://localhost:8080' },
+ *   networks: ['global']
+ * });
+ *
+ * // Register a tool
+ * client.registerTool('greet', async ({ name }) => {
+ *   return { message: `Hello, ${name}!` };
+ * });
+ *
+ * // Connect to brokers
+ * await client.connect();
+ *
+ * // Load an ability (explicit transport)
+ * const calc = await client.load('calculator', 'broker');
+ * const result = await calc.add({ a: 5, b: 3 });
+ *
+ * // Subscribe to events
+ * client.subscribeToEvent('user.*', (data) => {
+ *   console.log('User event:', data);
+ * });
+ *
+ * // Publish an event
+ * client.publishEvent('user.login', { userId: '123' });
+ * ```
+ */
+export class KadiClient extends EventEmitter {
+    /**
+     * Resolved configuration
+     */
+    config;
+    /**
+     * Tool registry
+     */
+    tools;
+    /**
+     * Event hub
+     */
+    events;
+    /**
+     * Broker connection manager
+     */
+    brokers;
+    /**
+     * Broker protocol instances (per broker)
+     */
+    protocols = new Map();
+    /**
+     * Ability loader
+     */
+    abilityLoader;
+    /**
+     * Whether client is initialized
+     */
+    initialized = false;
+    /**
+     * Create a new KADI Client
+     *
+     * @param config - Client configuration
+     */
+    constructor(config) {
+        super();
+        // Initialize specialized modules
+        this.tools = new ToolRegistry();
+        this.events = new EventHub('unknown'); // Will be updated after config resolution
+        this.brokers = new BrokerConnectionManager();
+        this.abilityLoader = new AbilityLoader();
+        // Resolve configuration (synchronous placeholder - will be async in connect())
+        // For now, create a minimal config
+        this.config = this.createMinimalConfig(config);
+        // Update event hub source to match client name
+        this.events.setSource(this.config.name);
+        // Forward broker events
+        this.setupBrokerEventForwarding();
+    }
+    /**
+     * Connect to configured brokers
+     *
+     * @throws {KadiError} If connection fails
+     *
+     * @example
+     * ```typescript
+     * await client.connect();
+     * console.log('Connected to brokers');
+     * ```
+     */
+    async connect() {
+        if (this.initialized) {
+            return;
+        }
+        // Resolve full configuration
+        const resolver = new ConfigResolver();
+        const resolved = await resolver.resolve(this.config);
+        Object.assign(this.config, resolved);
+        // Connect to brokers if configured
+        if (this.config.brokers && Object.keys(this.config.brokers).length > 0) {
+            await this.connectToBrokers();
+        }
+        this.initialized = true;
+        this.emit('ready');
+    }
+    /**
+     * Connect to all configured brokers
+     */
+    async connectToBrokers() {
+        if (!this.config.brokers) {
+            return;
+        }
+        const brokerConfigs = Object.entries(this.config.brokers).map(([name, url]) => ({
+            name,
+            url,
+            heartbeatInterval: this.config.advanced.heartbeatInterval,
+            requestTimeout: this.config.advanced.requestTimeout,
+            connectionTimeout: this.config.advanced.connectionTimeout
+        }));
+        // Connect to all brokers
+        await this.brokers.connectMultiple(brokerConfigs, this.config.defaultBroker);
+        // Perform handshake and register capabilities for each broker
+        for (const brokerName of this.brokers.getBrokerNames()) {
+            const connection = this.brokers.getConnection(brokerName);
+            if (!connection) {
+                continue;
+            }
+            // Create protocol instance
+            const protocol = new BrokerProtocol(connection);
+            this.protocols.set(brokerName, protocol);
+            // Perform handshake
+            await protocol.handshake({
+                role: this.config.role || 'agent',
+                name: this.config.name,
+                version: this.config.version,
+                protocolVersion: PROTOCOL_VERSION,
+                networks: this.config.networks
+            });
+            // Register capabilities
+            await this.registerCapabilitiesWithBroker(protocol);
+            // Start heartbeat
+            protocol.startHeartbeat(this.config.advanced.heartbeatInterval ?? 30000);
+        }
+    }
+    /**
+     * Register capabilities with a broker
+     *
+     * @param protocol - Broker protocol instance
+     */
+    async registerCapabilitiesWithBroker(protocol) {
+        const toolDefinitions = this.tools.extractDefinitions();
+        if (toolDefinitions.length > 0) {
+            await protocol.registerCapabilities({
+                tools: toolDefinitions,
+                networks: this.config.networks,
+                displayName: this.config.name
+            });
+        }
+    }
+    /**
+     * Register a tool (MCP-based)
+     *
+     * @template TInput - Tool input type
+     * @template TOutput - Tool output type
+     * @param definition - MCP-compliant tool definition
+     * @param handler - Tool handler function
+     * @returns this for chaining
+     *
+     * @example
+     * ```typescript
+     * client.registerTool({
+     *   name: 'add',
+     *   description: 'Add two numbers',
+     *   version: '1.0.0',
+     *   tags: ['math'],
+     *   inputSchema: {
+     *     type: 'object',
+     *     properties: {
+     *       a: { type: 'number' },
+     *       b: { type: 'number' }
+     *     },
+     *     required: ['a', 'b']
+     *   },
+     *   outputSchema: {
+     *     type: 'object',
+     *     properties: {
+     *       result: { type: 'number' }
+     *     }
+     *   }
+     * }, async ({ a, b }) => {
+     *   return { result: a + b };
+     * });
+     * ```
+     */
+    registerTool(definition, handler) {
+        this.tools.register(definition, handler);
+        // If already connected to brokers, register the new tool
+        if (this.initialized && this.protocols.size > 0) {
+            for (const protocol of this.protocols.values()) {
+                protocol.registerCapabilities({
+                    tools: [definition],
+                    networks: this.config.networks,
+                    displayName: this.config.name
+                }).catch(error => {
+                    this.emit('error', new KadiError(`Failed to register tool with broker: ${error instanceof Error ? error.message : String(error)}`, ErrorCode.BROKER_RESPONSE_ERROR, 500, { toolName: definition.name }));
+                });
+            }
+        }
+        return this;
+    }
+    /**
+     * Load an ability
+     *
+     * **Explicit Transport, Excellent Developer Experience:**
+     * - Explicit transport selection (no magic)
+     * - Transport-specific options (only relevant fields shown)
+     * - Smart caching (avoids duplicate loads)
+     * - Runtime validation (optional)
+     * - Helpful errors with suggestions
+     *
+     * @param name - Ability name
+     * @param transport - Transport type ('native', 'stdio', or 'broker')
+     * @param options - Load options (transport-specific, optional)
+     * @returns Proxied ability with dynamic method access
+     *
+     * @throws {KadiError} If loading fails
+     *
+     * @example
+     * ```typescript
+     * // Simple broker load
+     * const calc = await client.load('calculator', 'broker');
+     * await calc.add({ a: 5, b: 3 });
+     *
+     * // With options
+     * const remote = await client.load('gpu-service', 'broker', {
+     *   networks: ['global', 'gpu-cluster']
+     * });
+     *
+     * // With runtime validation
+     * const validated = await client.load('calculator', 'broker', {
+     *   validate: true  // Runtime check for expected methods
+     * });
+     *
+     * // Native transport
+     * const local = await client.load('math-lib', 'native', {
+     *   path: './abilities/math'
+     * });
+     * ```
+     */
+    async load(name, transport, options = {}) {
+        return await this.abilityLoader.load(name, transport, options, this);
+    }
+    /**
+     * Subscribe to events
+     *
+     * @template T - Event data type
+     * @param pattern - Event pattern (supports wildcards)
+     * @param callback - Event callback
+     * @returns Unsubscribe function
+     *
+     * @example
+     * ```typescript
+     * const unsubscribe = client.subscribeToEvent('user.*', (data) => {
+     *   console.log('User event:', data);
+     * });
+     *
+     * // Later...
+     * unsubscribe();
+     * ```
+     */
+    subscribeToEvent(pattern, callback) {
+        // Subscribe locally
+        const localUnsub = this.events.subscribe(pattern, callback);
+        // Subscribe on broker if connected
+        if (this.protocols.size > 0) {
+            const protocol = this.getBrokerProtocol();
+            protocol.subscribeToEvents({
+                channels: [pattern],
+                networkId: this.config.networks[0]
+            }).catch(error => {
+                this.emit('error', new KadiError(`Failed to subscribe to broker events: ${error instanceof Error ? error.message : String(error)}`, ErrorCode.EVENT_SUBSCRIPTION_FAILED, 500, { pattern }));
+            });
+        }
+        return localUnsub;
+    }
+    /**
+     * Publish an event
+     *
+     * @template T - Event data type
+     * @param eventName - Event name
+     * @param data - Event data
+     * @param options - Publishing options
+     *
+     * @example
+     * ```typescript
+     * client.publishEvent('user.login', {
+     *   userId: '123',
+     *   timestamp: Date.now()
+     * });
+     * ```
+     */
+    publishEvent(eventName, data, options) {
+        // Publish locally
+        this.events.publish(eventName, data, options);
+        // Publish to broker if connected
+        if (this.protocols.size > 0) {
+            const protocol = this.getBrokerProtocol();
+            protocol.publishEvent({
+                channel: eventName,
+                data,
+                networkId: this.config.networks[0],
+                hints: options
+            }).catch(error => {
+                this.emit('error', new KadiError(`Failed to publish event to broker: ${error instanceof Error ? error.message : String(error)}`, ErrorCode.EVENT_PUBLISH_FAILED, 500, { eventName }));
+            });
+        }
+    }
+    /**
+     * Disconnect from all brokers and cleanup
+     *
+     * @example
+     * ```typescript
+     * await client.disconnect();
+     * ```
+     */
+    async disconnect() {
+        // Stop all broker heartbeats
+        for (const protocol of this.protocols.values()) {
+            protocol.cleanup();
+        }
+        // Disconnect from all brokers
+        await this.brokers.disconnectAll();
+        // Unload all abilities
+        await this.abilityLoader.unloadAll();
+        // Clear event subscriptions
+        this.events.clear();
+        // Clear protocols
+        this.protocols.clear();
+        this.initialized = false;
+        this.emit('disconnected');
+    }
+    /**
+     * Get broker manager (implements IBrokerClient)
+     */
+    getBrokerManager() {
+        return this.brokers;
+    }
+    /**
+     * Get broker protocol instance (implements IBrokerClient)
+     *
+     * @param brokerName - Optional broker name (uses default if not specified)
+     */
+    getBrokerProtocol(brokerName) {
+        const name = brokerName ?? this.brokers.getDefaultBrokerName();
+        if (!name) {
+            throw new KadiError('No broker available', ErrorCode.BROKER_NOT_CONNECTED, 503);
+        }
+        const protocol = this.protocols.get(name);
+        if (!protocol) {
+            throw new KadiError(`Broker protocol not initialized for '${name}'`, ErrorCode.BROKER_NOT_CONNECTED, 503, { brokerName: name });
+        }
+        return protocol;
+    }
+    /**
+     * Networks (implements IBrokerClient)
+     */
+    get networks() {
+        return this.config.networks;
+    }
+    /**
+     * Create minimal configuration for constructor
+     * Full resolution happens in connect()
+     */
+    createMinimalConfig(config) {
+        const normalized = typeof config === 'string'
+            ? { brokers: { default: config } }
+            : config;
+        return {
+            name: normalized.name ?? 'unnamed-client',
+            version: normalized.version ?? '1.0.0',
+            description: normalized.description ?? '',
+            role: normalized.role ?? 'agent',
+            transport: normalized.transport ?? 'native',
+            brokers: normalized.brokers ?? { default: '' },
+            defaultBroker: normalized.defaultBroker ?? 'default',
+            networks: normalized.networks ?? ['global'],
+            abilityAgentJSON: normalized.abilityAgentJSON ?? '',
+            autoConnect: normalized.autoConnect ?? false,
+            advanced: {
+                heartbeatInterval: 30000,
+                requestTimeout: 30000,
+                connectionTimeout: 10000,
+                autoReconnect: true,
+                maxReconnectAttempts: 5,
+                verbose: false
+            },
+            sources: {}
+        };
+    }
+    /**
+     * Setup broker event forwarding
+     */
+    setupBrokerEventForwarding() {
+        this.brokers.on('brokerMessage', async (brokerName, message) => {
+            if (!message || typeof message !== 'object' || !('method' in message)) {
+                return;
+            }
+            const msg = message;
+            // Handle incoming tool invocation requests
+            if (msg.method === KadiMessages.ABILITY_REQUEST && msg.params) {
+                await this.handleIncomingToolRequest(brokerName, msg);
+                return;
+            }
+            // Handle event deliveries
+            if (msg.method === KadiMessages.EVENT_DELIVERY && msg.params) {
+                const { channel, data } = msg.params;
+                if (channel && data !== undefined) {
+                    this.events.publish(channel, data);
+                }
+            }
+        });
+    }
+    /**
+     * Handle incoming tool invocation requests from broker
+     *
+     * Flow:
+     * 1. Extract id from top-level message (JSON-RPC request id)
+     * 2. Look up tool handler by name
+     * 3. Execute handler with toolInput
+     * 4. Send JSON-RPC response back to broker with matching id
+     *
+     * @param brokerName - Name of the broker connection to use for response
+     * @param message - Full JSON-RPC request message with id, method, and params
+     * @private
+     */
+    async handleIncomingToolRequest(brokerName, message) {
+        const { toolName, toolInput } = message.params || {};
+        const requestId = message.id;
+        try {
+            // Step 1: Look up the tool handler
+            const handler = this.tools.getHandler(toolName);
+            if (!handler) {
+                throw new KadiError(`Tool '${toolName}' not found`, ErrorCode.TOOL_NOT_FOUND, 404, { toolName });
+            }
+            // Step 2: Execute the handler
+            const result = await handler(toolInput);
+            // Step 3: Send JSON-RPC response back to broker
+            // CRITICAL: id must match the incoming request id for proper routing
+            const connection = this.brokers.getConnection(brokerName);
+            if (!connection) {
+                console.error(`[DEBUG] No connection found for broker: ${brokerName}`);
+                return;
+            }
+            connection.sendResponse(requestId, result);
+        }
+        catch (error) {
+            // Send JSON-RPC error response back to broker with same id for proper routing
+            const connection = this.brokers.getConnection(brokerName);
+            if (connection) {
+                const kadiError = error instanceof KadiError ? error : KadiError.from(error);
+                connection.sendError(requestId, kadiError.code, kadiError.message);
+            }
+        }
+    }
+}
+//# sourceMappingURL=KadiClient.js.map

package/dist/client/KadiClient.js.map

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

package/dist/client/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Client Module
+ *
+ * Exports for KADI client.
+ */
+export { KadiClient } from './KadiClient.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/client/index.js

@@ -0,0 +1,7 @@
+/**
+ * Client Module
+ *
+ * Exports for KADI client.
+ */
+export { KadiClient } from './KadiClient.js';
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

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

package/dist/config/ConfigLoader.d.ts

@@ -0,0 +1,138 @@
+/**
+ * Configuration Loader
+ *
+ * Loads configuration from various sources:
+ * - Environment variables
+ * - Configuration files (agent.json, kadi.config.json)
+ * - Package.json
+ *
+ * @module config/ConfigLoader
+ */
+import type { AgentJsonConfig, EnvConfig } from '../types/index.js';
+/**
+ * Configuration Loader
+ *
+ * Handles the actual loading of configuration from files and environment.
+ * Separated from ConfigResolver for testability.
+ *
+ * @example
+ * ```typescript
+ * const loader = new ConfigLoader();
+ *
+ * // Load from environment
+ * const envConfig = loader.loadFromEnvironment();
+ *
+ * // Load from file
+ * const fileConfig = await loader.loadFromFile();
+ * ```
+ */
+export declare class ConfigLoader {
+    /**
+     * Configuration file names to search for (in order of preference)
+     */
+    private readonly configFiles;
+    /**
+     * Load configuration from environment variables
+     *
+     * Reads KADI_* environment variables and returns structured config.
+     *
+     * @returns Environment configuration
+     *
+     * @example
+     * ```typescript
+     * // With environment variables:
+     * // KADI_BROKER_URL=ws://localhost:8080
+     * // KADI_NETWORKS=global,team-alpha
+     *
+     * const config = loader.loadFromEnvironment();
+     * // { KADI_BROKER_URL: 'ws://localhost:8080', KADI_NETWORKS: 'global,team-alpha' }
+     * ```
+     */
+    loadFromEnvironment(): EnvConfig;
+    /**
+     * Load configuration from file
+     *
+     * Searches for configuration files in order of preference:
+     * 1. agent.json
+     * 2. kadi.config.json
+     * 3. .kadirc.json
+     *
+     * Searches from current directory up to root.
+     *
+     * @param startDir - Directory to start searching from (defaults to cwd)
+     * @returns Loaded configuration or null if not found
+     *
+     * @example
+     * ```typescript
+     * const config = await loader.loadFromFile();
+     * if (config) {
+     *   console.log('Loaded from:', config.name);
+     * }
+     * ```
+     */
+    loadFromFile(startDir?: string): Promise<AgentJsonConfig | null>;
+    /**
+     * Find a configuration file by searching up the directory tree
+     *
+     * @param filename - Config filename to search for
+     * @param startDir - Directory to start searching from
+     * @returns Full path to config file or null if not found
+     */
+    private findConfigFile;
+    /**
+     * Load and parse a configuration file
+     *
+     * @param filePath - Path to configuration file
+     * @returns Parsed configuration
+     * @throws If file cannot be read or parsed
+     */
+    private loadConfigFile;
+    /**
+     * Load KADI configuration from package.json
+     *
+     * Looks for a "kadi" field in package.json
+     *
+     * @param startDir - Directory to start searching from
+     * @returns Configuration from package.json or null
+     *
+     * @example
+     * ```json
+     * // package.json
+     * {
+     *   "name": "my-package",
+     *   "kadi": {
+     *     "name": "my-service",
+     *     "brokers": {
+     *       "local": "ws://localhost:8080"
+     *     }
+     *   }
+     * }
+     * ```
+     */
+    private loadFromPackageJson;
+    /**
+     * Parse transport string to TransportKind
+     *
+     * @param value - Transport string
+     * @returns TransportKind or undefined
+     */
+    private parseTransport;
+    /**
+     * Get configuration file path if one exists
+     *
+     * Useful for debugging and logging which config file is being used.
+     *
+     * @param startDir - Directory to start searching from
+     * @returns Path to config file or null
+     *
+     * @example
+     * ```typescript
+     * const configPath = loader.getConfigPath();
+     * if (configPath) {
+     *   console.log('Using config from:', configPath);
+     * }
+     * ```
+     */
+    getConfigPath(startDir?: string): string | null;
+}
+//# sourceMappingURL=ConfigLoader.d.ts.map

package/dist/config/ConfigLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigLoader.d.ts","sourceRoot":"","sources":["../../src/config/ConfigLoader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,SAAS,EAAiB,MAAM,mBAAmB,CAAC;AAEnF;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,YAAY;IACvB;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,WAAW,CAI1B;IAEF;;;;;;;;;;;;;;;;OAgBG;IACH,mBAAmB,IAAI,SAAS;IAUhC;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,YAAY,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAoBtE;;;;;;OAMG;IACH,OAAO,CAAC,cAAc;IAqBtB;;;;;;OAMG;IACH,OAAO,CAAC,cAAc;IAWtB;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,OAAO,CAAC,mBAAmB;IAoB3B;;;;;OAKG;IACH,OAAO,CAAC,cAAc;IAatB;;;;;;;;;;;;;;;OAeG;IACH,aAAa,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;CAYhD"}