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

package/dist/transports/BrokerTransport.d.ts

@@ -0,0 +1,151 @@
+/**
+ * Broker Transport
+ *
+ * Accesses abilities on remote agents via broker communication.
+ * Enables distributed system architecture with service discovery.
+ *
+ * @module transports/BrokerTransport
+ */
+import { EventEmitter } from 'events';
+import type { AbilityTransport, BrokerTransportOptions, MethodSchema } from '../types/index.js';
+import type { BrokerConnectionManager } from '../broker/BrokerConnectionManager.js';
+import type { BrokerProtocol } from '../broker/BrokerProtocol.js';
+/**
+ * Broker Client Interface
+ *
+ * Defines the minimal interface BrokerTransport needs from the client.
+ * This breaks the circular dependency between transport and client.
+ */
+export interface IBrokerClient {
+    /**
+     * Get the broker connection manager
+     */
+    getBrokerManager(): BrokerConnectionManager;
+    /**
+     * Get broker protocol instance for a specific broker
+     */
+    getBrokerProtocol(brokerName?: string): BrokerProtocol;
+    /**
+     * Networks this client is part of
+     */
+    networks: string[];
+}
+/**
+ * Broker Transport
+ *
+ * Communicates with remote abilities via broker infrastructure.
+ * Provides service discovery and load balancing across multiple brokers.
+ *
+ * @example
+ * ```typescript
+ * const transport = new BrokerTransport({
+ *   abilityName: 'calculator',
+ *   brokerUrl: 'ws://localhost:8080',
+ *   networks: ['global']
+ * }, client);
+ *
+ * await transport.connect();
+ * const result = await transport.invoke('add', { a: 5, b: 3 });
+ * ```
+ */
+export declare class BrokerTransport extends EventEmitter implements AbilityTransport {
+    /**
+     * Transport configuration
+     */
+    private readonly options;
+    /**
+     * Broker client interface
+     */
+    private readonly client;
+    /**
+     * Discovered methods
+     */
+    private methods;
+    /**
+     * Method schemas
+     */
+    private schemas;
+    /**
+     * Whether transport is connected
+     */
+    private connected;
+    /**
+     * Target agent name (resolved during discovery)
+     */
+    private targetAgent;
+    /**
+     * Create a new BrokerTransport
+     *
+     * @param options - Broker transport options
+     * @param client - Broker client interface
+     */
+    constructor(options: BrokerTransportOptions, client: IBrokerClient);
+    /**
+     * Connect to the ability
+     *
+     * Discovers the ability on the broker network and queries its capabilities.
+     *
+     * @throws {KadiError} If ability cannot be found or discovery fails
+     *
+     * @example
+     * ```typescript
+     * await transport.connect();
+     * console.log('Connected to remote ability');
+     * ```
+     */
+    connect(): Promise<void>;
+    /**
+     * Invoke a method on the remote ability
+     *
+     * @template TInput - Input parameter type
+     * @template TOutput - Return type
+     *
+     * @param method - Method name
+     * @param params - Method parameters
+     * @returns Promise resolving to method result
+     *
+     * @throws {KadiError} If method doesn't exist or invocation fails
+     *
+     * @example
+     * ```typescript
+     * const result = await transport.invoke<{ a: number; b: number }, { result: number }>(
+     *   'add',
+     *   { a: 5, b: 3 }
+     * );
+     * ```
+     */
+    invoke<TInput = unknown, TOutput = unknown>(method: string, params: TInput): Promise<TOutput>;
+    /**
+     * Get list of available methods
+     *
+     * @returns Array of method names
+     */
+    getMethods(): string[];
+    /**
+     * Get schema for a specific method
+     *
+     * @param method - Method name
+     * @returns Method schema or undefined
+     */
+    getMethodSchema(method: string): MethodSchema | undefined;
+    /**
+     * Disconnect from the ability
+     *
+     * Note: Does not disconnect the underlying broker connection,
+     * as it may be shared with other transports.
+     *
+     * @example
+     * ```typescript
+     * await transport.disconnect();
+     * ```
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Publish an event from the ability
+     *
+     * @param eventName - Event name
+     * @param data - Event data
+     */
+    publishEvent(eventName: string, data: unknown): void;
+}
+//# sourceMappingURL=BrokerTransport.d.ts.map

package/dist/transports/BrokerTransport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrokerTransport.d.ts","sourceRoot":"","sources":["../../src/transports/BrokerTransport.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EACV,gBAAgB,EAChB,sBAAsB,EACtB,YAAY,EACb,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AACpF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAElE;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,gBAAgB,IAAI,uBAAuB,CAAC;IAE5C;;OAEG;IACH,iBAAiB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,cAAc,CAAC;IAEvD;;OAEG;IACH,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,eAAgB,SAAQ,YAAa,YAAW,gBAAgB;IAC3E;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmC;IAE3D;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IAEvC;;OAEG;IACH,OAAO,CAAC,OAAO,CAAgB;IAE/B;;OAEG;IACH,OAAO,CAAC,OAAO,CAAmC;IAElD;;OAEG;IACH,OAAO,CAAC,SAAS,CAAS;IAE1B;;OAEG;IACH,OAAO,CAAC,WAAW,CAAuB;IAE1C;;;;;OAKG;gBACS,OAAO,EAAE,sBAAsB,EAAE,MAAM,EAAE,aAAa;IAgBlE;;;;;;;;;;;;OAYG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA0E9B;;;;;;;;;;;;;;;;;;;OAmBG;IACG,MAAM,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,EAC9C,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,OAAO,CAAC;IAgEnB;;;;OAIG;IACH,UAAU,IAAI,MAAM,EAAE;IAItB;;;;;OAKG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAIzD;;;;;;;;;;OAUG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAejC;;;;;OAKG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI;CA8BrD"}

package/dist/transports/BrokerTransport.js

@@ -0,0 +1,261 @@
+/**
+ * Broker Transport
+ *
+ * Accesses abilities on remote agents via broker communication.
+ * Enables distributed system architecture with service discovery.
+ *
+ * @module transports/BrokerTransport
+ */
+import { EventEmitter } from 'events';
+import { KadiError, ErrorCode } from '../types/index.js';
+/**
+ * Broker Transport
+ *
+ * Communicates with remote abilities via broker infrastructure.
+ * Provides service discovery and load balancing across multiple brokers.
+ *
+ * @example
+ * ```typescript
+ * const transport = new BrokerTransport({
+ *   abilityName: 'calculator',
+ *   brokerUrl: 'ws://localhost:8080',
+ *   networks: ['global']
+ * }, client);
+ *
+ * await transport.connect();
+ * const result = await transport.invoke('add', { a: 5, b: 3 });
+ * ```
+ */
+export class BrokerTransport extends EventEmitter {
+    /**
+     * Transport configuration
+     */
+    options;
+    /**
+     * Broker client interface
+     */
+    client;
+    /**
+     * Discovered methods
+     */
+    methods = [];
+    /**
+     * Method schemas
+     */
+    schemas = new Map();
+    /**
+     * Whether transport is connected
+     */
+    connected = false;
+    /**
+     * Target agent name (resolved during discovery)
+     */
+    targetAgent = null;
+    /**
+     * Create a new BrokerTransport
+     *
+     * @param options - Broker transport options
+     * @param client - Broker client interface
+     */
+    constructor(options, client) {
+        super();
+        this.options = {
+            timeout: options.timeout ?? 30000,
+            networks: options.networks ?? client.networks,
+            brokerUrl: options.brokerUrl,
+            brokerName: options.brokerName ?? 'default',
+            authToken: options.authToken ?? '',
+            abilityName: options.abilityName,
+            abilityVersion: options.abilityVersion ?? '0.0.1'
+        };
+        this.client = client;
+    }
+    /**
+     * Connect to the ability
+     *
+     * Discovers the ability on the broker network and queries its capabilities.
+     *
+     * @throws {KadiError} If ability cannot be found or discovery fails
+     *
+     * @example
+     * ```typescript
+     * await transport.connect();
+     * console.log('Connected to remote ability');
+     * ```
+     */
+    async connect() {
+        if (this.connected) {
+            return;
+        }
+        try {
+            // Get broker protocol
+            const protocol = this.client.getBrokerProtocol(this.options.brokerName);
+            // Discover agents on the network
+            const agents = await protocol.discoverAgents(this.options.networks);
+            // Find the target ability
+            const targetAgent = agents.find(agent => agent.name === this.options.abilityName ||
+                agent.capabilities.includes(this.options.abilityName));
+            if (!targetAgent) {
+                throw new KadiError(`Ability '${this.options.abilityName}' not found on networks: ${this.options.networks.join(', ')}`, ErrorCode.ABILITY_NOT_FOUND, 404, {
+                    abilityName: this.options.abilityName,
+                    networks: this.options.networks,
+                    availableAgents: agents.map(a => a.name)
+                });
+            }
+            this.targetAgent = targetAgent.name;
+            // Query capabilities
+            const capabilities = await protocol.queryCapabilities(this.targetAgent, this.options.networks);
+            // Extract methods and schemas
+            this.methods = capabilities.map(cap => cap.name);
+            for (const cap of capabilities) {
+                if (cap.inputSchema || cap.outputSchema) {
+                    this.schemas.set(cap.name, {
+                        description: cap.description,
+                        inputSchema: cap.inputSchema,
+                        outputSchema: cap.outputSchema
+                    });
+                }
+            }
+            this.connected = true;
+            this.emit('connected');
+        }
+        catch (error) {
+            const kadiError = error instanceof KadiError
+                ? error
+                : new KadiError(`Failed to connect to ability: ${error instanceof Error ? error.message : String(error)}`, ErrorCode.ABILITY_LOAD_FAILED, 500, {
+                    abilityName: this.options.abilityName,
+                    networks: this.options.networks,
+                    originalError: error instanceof Error ? error.message : String(error)
+                });
+            this.emit('error', kadiError);
+            throw kadiError;
+        }
+    }
+    /**
+     * Invoke a method on the remote ability
+     *
+     * @template TInput - Input parameter type
+     * @template TOutput - Return type
+     *
+     * @param method - Method name
+     * @param params - Method parameters
+     * @returns Promise resolving to method result
+     *
+     * @throws {KadiError} If method doesn't exist or invocation fails
+     *
+     * @example
+     * ```typescript
+     * const result = await transport.invoke<{ a: number; b: number }, { result: number }>(
+     *   'add',
+     *   { a: 5, b: 3 }
+     * );
+     * ```
+     */
+    async invoke(method, params) {
+        if (!this.connected || !this.targetAgent) {
+            throw new KadiError('Transport not connected', ErrorCode.TRANSPORT_NOT_CONNECTED, 503, { abilityName: this.options.abilityName });
+        }
+        // Check if method exists
+        if (!this.methods.includes(method)) {
+            throw new KadiError(`Method '${method}' not found on ability '${this.options.abilityName}'`, ErrorCode.ABILITY_METHOD_NOT_FOUND, 404, {
+                abilityName: this.options.abilityName,
+                method,
+                availableMethods: this.methods
+            });
+        }
+        try {
+            // Get broker protocol
+            const protocol = this.client.getBrokerProtocol(this.options.brokerName);
+            // Invoke tool via broker
+            const result = await protocol.invokeTool({
+                targetAgent: this.targetAgent,
+                toolName: method,
+                toolInput: params,
+                timeout: this.options.timeout
+            });
+            return result;
+        }
+        catch (error) {
+            // Don't wrap KadiError
+            if (error instanceof KadiError) {
+                throw error;
+            }
+            // Enhance the original error
+            if (error instanceof Error) {
+                const enhancedError = error;
+                enhancedError.message = `${error.message} (in remote ${this.options.abilityName}.${method})`;
+                throw enhancedError;
+            }
+            throw new KadiError(`Remote method invocation failed: ${String(error)}`, ErrorCode.TOOL_INVOCATION_FAILED, 500, {
+                abilityName: this.options.abilityName,
+                targetAgent: this.targetAgent,
+                method
+            });
+        }
+    }
+    /**
+     * Get list of available methods
+     *
+     * @returns Array of method names
+     */
+    getMethods() {
+        return [...this.methods];
+    }
+    /**
+     * Get schema for a specific method
+     *
+     * @param method - Method name
+     * @returns Method schema or undefined
+     */
+    getMethodSchema(method) {
+        return this.schemas.get(method);
+    }
+    /**
+     * Disconnect from the ability
+     *
+     * Note: Does not disconnect the underlying broker connection,
+     * as it may be shared with other transports.
+     *
+     * @example
+     * ```typescript
+     * await transport.disconnect();
+     * ```
+     */
+    async disconnect() {
+        if (!this.connected) {
+            return;
+        }
+        // Just mark as disconnected - don't close broker connection
+        // The broker connection is managed by BrokerConnectionManager
+        this.connected = false;
+        this.targetAgent = null;
+        this.methods = [];
+        this.schemas.clear();
+        this.emit('disconnected');
+    }
+    /**
+     * Publish an event from the ability
+     *
+     * @param eventName - Event name
+     * @param data - Event data
+     */
+    publishEvent(eventName, data) {
+        if (!this.connected) {
+            return;
+        }
+        try {
+            const protocol = this.client.getBrokerProtocol(this.options.brokerName);
+            protocol.publishEvent({
+                channel: eventName,
+                data,
+                networkId: this.options.networks[0] // Use first network
+            }).catch(error => {
+                this.emit('error', new KadiError(`Failed to publish event: ${error instanceof Error ? error.message : String(error)}`, ErrorCode.EVENT_PUBLISH_FAILED, 500, { abilityName: this.options.abilityName, eventName }));
+            });
+        }
+        catch (error) {
+            this.emit('error', new KadiError(`Failed to publish event: ${error instanceof Error ? error.message : String(error)}`, ErrorCode.EVENT_PUBLISH_FAILED, 500, { abilityName: this.options.abilityName, eventName }));
+        }
+    }
+}
+//# sourceMappingURL=BrokerTransport.js.map

package/dist/transports/BrokerTransport.js.map

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

package/dist/transports/NativeTransport.d.ts

@@ -0,0 +1,178 @@
+/**
+ * Native Transport
+ *
+ * Loads abilities in-process for zero-overhead communication.
+ * Best for abilities written in JavaScript/TypeScript that can run in the same process.
+ *
+ * @module transports/NativeTransport
+ */
+import { EventEmitter } from 'events';
+import type { AbilityTransport, NativeTransportOptions, MethodSchema } from '../types/index.js';
+import type { AgentJson } from '../abilities/types.js';
+/**
+ * Native Transport
+ *
+ * Loads Node.js modules directly into the current process.
+ * Provides zero-overhead method invocation since everything runs in-process.
+ *
+ * @example
+ * ```typescript
+ * const transport = new NativeTransport({
+ *   abilityName: 'calculator',
+ *   abilityPath: '/path/to/calculator',
+ *   entryPoint: 'index.js'
+ * });
+ *
+ * await transport.connect();
+ * const result = await transport.invoke('add', { a: 5, b: 3 });
+ * console.log(result); // { result: 8 }
+ * ```
+ */
+export declare class NativeTransport extends EventEmitter implements AbilityTransport {
+    /**
+     * Transport configuration
+     */
+    private readonly options;
+    /**
+     * Loaded ability module
+     */
+    private ability;
+    /**
+     * Whether loaded module is a KadiClient instance
+     */
+    private isKadiClientInstance;
+    /**
+     * Discovered methods
+     */
+    private methods;
+    /**
+     * Method schemas
+     */
+    private schemas;
+    /**
+     * Whether transport is connected
+     */
+    private connected;
+    /**
+     * Create a new NativeTransport
+     *
+     * @param options - Native transport options
+     */
+    constructor(options: NativeTransportOptions);
+    /**
+     * Connect to the ability
+     *
+     * Loads the module from disk and performs discovery.
+     *
+     * @throws {KadiError} If module cannot be loaded
+     *
+     * @example
+     * ```typescript
+     * await transport.connect();
+     * ```
+     */
+    connect(): Promise<void>;
+    /**
+     * Invoke a method on the ability
+     *
+     * @template TInput - Input parameter type
+     * @template TOutput - Return type
+     *
+     * @param method - Method name
+     * @param params - Method parameters
+     * @returns Promise resolving to method result
+     *
+     * @throws {KadiError} If method doesn't exist or invocation fails
+     *
+     * @example
+     * ```typescript
+     * const result = await transport.invoke<{ a: number; b: number }, { result: number }>(
+     *   'add',
+     *   { a: 5, b: 3 }
+     * );
+     * ```
+     */
+    invoke<TInput = unknown, TOutput = unknown>(method: string, params: TInput): Promise<TOutput>;
+    /**
+     * Get list of available methods
+     *
+     * @returns Array of method names
+     *
+     * @example
+     * ```typescript
+     * const methods = transport.getMethods();
+     * console.log('Available methods:', methods);
+     * ```
+     */
+    getMethods(): string[];
+    /**
+     * Get schema for a specific method
+     *
+     * @param method - Method name
+     * @returns Method schema or undefined
+     *
+     * @example
+     * ```typescript
+     * const schema = transport.getMethodSchema('add');
+     * if (schema) {
+     *   console.log('Input schema:', schema.inputSchema);
+     * }
+     * ```
+     */
+    getMethodSchema(method: string): MethodSchema | undefined;
+    /**
+     * Read agent.json representation (only for KadiClient instances)
+     *
+     * Returns the agent.json representation from KadiClient.readAgentJson() if
+     * the loaded module is a KadiClient instance. Returns undefined for legacy modules.
+     *
+     * **What this returns:**
+     * - Runtime representation of the ability's agent.json file
+     * - Contains name, version, description, and tools (mapped from agent.json's 'exports')
+     * - Used for type generation during `kadi install`
+     *
+     * @returns agent.json representation or undefined
+     *
+     * @example
+     * ```typescript
+     * const agentJson = transport.readAgentJson();
+     * if (agentJson) {
+     *   console.log('Ability:', agentJson.name, agentJson.version);
+     *   console.log('Tools:', agentJson.tools.map(t => t.name));
+     *   // This represents what's in the ability's agent.json file
+     * }
+     * ```
+     */
+    readAgentJson(): AgentJson | undefined;
+    /**
+     * Disconnect from the ability
+     *
+     * Cleans up resources and removes references.
+     *
+     * @example
+     * ```typescript
+     * await transport.disconnect();
+     * ```
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Publish an event from the ability
+     *
+     * @param eventName - Event name
+     * @param data - Event data
+     *
+     * @example
+     * ```typescript
+     * transport.publishEvent('calculation.completed', { result: 42 });
+     * ```
+     */
+    publishEvent(eventName: string, data: unknown): void;
+    /**
+     * Discover methods on the loaded ability
+     *
+     * Introspects the ability object to find callable methods.
+     * Excludes internal methods (starting with _) and special methods.
+     */
+    private discoverMethods;
+}
+//# sourceMappingURL=NativeTransport.d.ts.map

package/dist/transports/NativeTransport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NativeTransport.d.ts","sourceRoot":"","sources":["../../src/transports/NativeTransport.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,KAAK,EACV,gBAAgB,EAChB,sBAAsB,EACtB,YAAY,EACb,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAiDvD;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,eAAgB,SAAQ,YAAa,YAAW,gBAAgB;IAC3E;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmC;IAE3D;;OAEG;IACH,OAAO,CAAC,OAAO,CAAiB;IAEhC;;OAEG;IACH,OAAO,CAAC,oBAAoB,CAAS;IAErC;;OAEG;IACH,OAAO,CAAC,OAAO,CAAgB;IAE/B;;OAEG;IACH,OAAO,CAAC,OAAO,CAAmC;IAElD;;OAEG;IACH,OAAO,CAAC,SAAS,CAAS;IAE1B;;;;OAIG;gBACS,OAAO,EAAE,sBAAsB;IAW3C;;;;;;;;;;;OAWG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAqE9B;;;;;;;;;;;;;;;;;;;OAmBG;IACG,MAAM,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,EAC9C,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,OAAO,CAAC;IA+FnB;;;;;;;;;;OAUG;IACH,UAAU,IAAI,MAAM,EAAE;IAItB;;;;;;;;;;;;;OAaG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAIzD;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,aAAa,IAAI,SAAS,GAAG,SAAS;IAQtC;;;;;;;;;OASG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAcjC;;;;;;;;;;OAUG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI;IASpD;;;;;OAKG;YACW,eAAe;CA6D9B"}