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

package/dist/transports/NativeTransport.js

@@ -0,0 +1,302 @@
+/**
+ * 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 { resolve } from 'path';
+import { KadiError, ErrorCode } from '../types/index.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 class NativeTransport extends EventEmitter {
+    /**
+     * Transport configuration
+     */
+    options;
+    /**
+     * Loaded ability module
+     */
+    ability = null;
+    /**
+     * Discovered methods
+     */
+    methods = [];
+    /**
+     * Method schemas
+     */
+    schemas = new Map();
+    /**
+     * Whether transport is connected
+     */
+    connected = false;
+    /**
+     * Create a new NativeTransport
+     *
+     * @param options - Native transport options
+     */
+    constructor(options) {
+        super();
+        this.options = {
+            entryPoint: options.entryPoint ?? 'index.js',
+            timeout: options.timeout ?? 30000,
+            abilityPath: options.abilityPath,
+            abilityName: options.abilityName,
+            abilityVersion: options.abilityVersion ?? '1.0.0'
+        };
+    }
+    /**
+     * Connect to the ability
+     *
+     * Loads the module from disk and performs discovery.
+     *
+     * @throws {KadiError} If module cannot be loaded
+     *
+     * @example
+     * ```typescript
+     * await transport.connect();
+     * ```
+     */
+    async connect() {
+        if (this.connected) {
+            return;
+        }
+        try {
+            // Resolve module path
+            const modulePath = resolve(this.options.abilityPath, this.options.entryPoint);
+            // Load the module
+            const module = await import(modulePath);
+            // Get the ability (default export or named export)
+            this.ability = module.default ?? module;
+            if (!this.ability || typeof this.ability !== 'object') {
+                throw new KadiError(`Ability module must export an object or class instance`, ErrorCode.ABILITY_LOAD_FAILED, 500, { abilityName: this.options.abilityName, modulePath });
+            }
+            // Discover methods
+            await this.discoverMethods();
+            this.connected = true;
+            this.emit('connected');
+        }
+        catch (error) {
+            const kadiError = error instanceof KadiError
+                ? error
+                : new KadiError(`Failed to load ability: ${error instanceof Error ? error.message : String(error)}`, ErrorCode.ABILITY_LOAD_FAILED, 500, {
+                    abilityName: this.options.abilityName,
+                    abilityPath: this.options.abilityPath,
+                    originalError: error instanceof Error ? error.message : String(error)
+                });
+            this.emit('error', kadiError);
+            throw kadiError;
+        }
+    }
+    /**
+     * 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 }
+     * );
+     * ```
+     */
+    async invoke(method, params) {
+        if (!this.connected) {
+            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 the method function
+            const handler = this.ability[method];
+            if (typeof handler !== 'function') {
+                throw new KadiError(`Method '${method}' is not a function`, ErrorCode.ABILITY_METHOD_NOT_FOUND, 500, { abilityName: this.options.abilityName, method, type: typeof handler });
+            }
+            // Invoke with timeout
+            const timeoutPromise = new Promise((_, reject) => {
+                setTimeout(() => {
+                    reject(new KadiError(`Method invocation timeout after ${this.options.timeout}ms`, ErrorCode.TOOL_TIMEOUT, 408, { abilityName: this.options.abilityName, method, timeout: this.options.timeout }));
+                }, this.options.timeout);
+            });
+            const result = await Promise.race([
+                handler.call(this.ability, params),
+                timeoutPromise
+            ]);
+            return result;
+        }
+        catch (error) {
+            // Don't wrap KadiError
+            if (error instanceof KadiError) {
+                throw error;
+            }
+            // Enhance the original error with context
+            if (error instanceof Error) {
+                const enhancedError = error;
+                enhancedError.message = `${error.message} (in ${this.options.abilityName}.${method})`;
+                throw enhancedError;
+            }
+            throw new KadiError(`Method invocation failed: ${String(error)}`, ErrorCode.TOOL_INVOCATION_FAILED, 500, { abilityName: this.options.abilityName, method });
+        }
+    }
+    /**
+     * Get list of available methods
+     *
+     * @returns Array of method names
+     *
+     * @example
+     * ```typescript
+     * const methods = transport.getMethods();
+     * console.log('Available methods:', methods);
+     * ```
+     */
+    getMethods() {
+        return [...this.methods];
+    }
+    /**
+     * 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) {
+        return this.schemas.get(method);
+    }
+    /**
+     * Disconnect from the ability
+     *
+     * Cleans up resources and removes references.
+     *
+     * @example
+     * ```typescript
+     * await transport.disconnect();
+     * ```
+     */
+    async disconnect() {
+        if (!this.connected) {
+            return;
+        }
+        // Clean up
+        this.ability = null;
+        this.methods = [];
+        this.schemas.clear();
+        this.connected = false;
+        this.emit('disconnected');
+    }
+    /**
+     * Publish an event from the ability
+     *
+     * @param eventName - Event name
+     * @param data - Event data
+     *
+     * @example
+     * ```typescript
+     * transport.publishEvent('calculation.completed', { result: 42 });
+     * ```
+     */
+    publishEvent(eventName, data) {
+        this.emit('event', {
+            eventName,
+            data,
+            timestamp: Date.now(),
+            source: this.options.abilityName
+        });
+    }
+    /**
+     * Discover methods on the loaded ability
+     *
+     * Introspects the ability object to find callable methods.
+     * Excludes internal methods (starting with _) and special methods.
+     */
+    async discoverMethods() {
+        if (!this.ability || typeof this.ability !== 'object') {
+            return;
+        }
+        const excludedMethods = new Set([
+            'constructor',
+            'toString',
+            'toJSON',
+            'valueOf',
+            'hasOwnProperty',
+            'isPrototypeOf',
+            'propertyIsEnumerable'
+        ]);
+        // Get all property names (own and inherited)
+        const allProps = new Set();
+        // Own properties
+        for (const prop of Object.getOwnPropertyNames(this.ability)) {
+            allProps.add(prop);
+        }
+        // Prototype properties
+        let proto = Object.getPrototypeOf(this.ability);
+        while (proto && proto !== Object.prototype) {
+            for (const prop of Object.getOwnPropertyNames(proto)) {
+                allProps.add(prop);
+            }
+            proto = Object.getPrototypeOf(proto);
+        }
+        // Filter to functions, exclude internal methods
+        for (const prop of allProps) {
+            if (excludedMethods.has(prop)) {
+                continue;
+            }
+            if (prop.startsWith('_')) {
+                continue; // Internal method
+            }
+            try {
+                const value = this.ability[prop];
+                if (typeof value === 'function') {
+                    this.methods.push(prop);
+                    // Try to get schema if available
+                    const schemaGetter = this.ability[`${prop}Schema`];
+                    if (typeof schemaGetter === 'function') {
+                        const schema = schemaGetter.call(this.ability);
+                        if (schema) {
+                            this.schemas.set(prop, schema);
+                        }
+                    }
+                }
+            }
+            catch {
+                // Skip properties that throw on access
+            }
+        }
+    }
+}
+//# sourceMappingURL=NativeTransport.js.map

package/dist/transports/NativeTransport.js.map

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

package/dist/transports/StdioTransport.d.ts

@@ -0,0 +1,172 @@
+/**
+ * Stdio Transport
+ *
+ * Communicates with abilities running as child processes via stdin/stdout.
+ * Enables using abilities written in any language that supports JSON over stdio.
+ *
+ * @module transports/StdioTransport
+ */
+import { EventEmitter } from 'events';
+import type { AbilityTransport, StdioTransportOptions, MethodSchema } from '../types/index.js';
+/**
+ * Stdio Transport
+ *
+ * Spawns a child process and communicates via JSON messages over stdin/stdout.
+ * Uses length-prefixed framing for reliable message boundaries.
+ *
+ * @example
+ * ```typescript
+ * const transport = new StdioTransport({
+ *   abilityName: 'python-calculator',
+ *   abilityPath: '/path/to/calculator',
+ *   command: 'python3',
+ *   args: ['main.py']
+ * });
+ *
+ * await transport.connect();
+ * const result = await transport.invoke('calculate', { expr: '2 + 2' });
+ * ```
+ */
+export declare class StdioTransport extends EventEmitter implements AbilityTransport {
+    /**
+     * Transport configuration
+     */
+    private readonly options;
+    /**
+     * Child process instance
+     */
+    private process;
+    /**
+     * Discovered methods
+     */
+    private methods;
+    /**
+     * Method schemas
+     */
+    private schemas;
+    /**
+     * Whether transport is connected
+     */
+    private connected;
+    /**
+     * Pending requests waiting for responses
+     */
+    private pendingRequests;
+    /**
+     * Buffer for incomplete messages
+     */
+    private buffer;
+    /**
+     * Create a new StdioTransport
+     *
+     * @param options - Stdio transport options
+     */
+    constructor(options: StdioTransportOptions);
+    /**
+     * Connect to the ability
+     *
+     * Spawns the child process and performs method discovery.
+     *
+     * @throws {KadiError} If process fails to start or discovery fails
+     *
+     * @example
+     * ```typescript
+     * await transport.connect();
+     * console.log('Process started');
+     * ```
+     */
+    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('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
+     *
+     * Terminates the child process and cleans up resources.
+     *
+     * @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;
+    /**
+     * Discover methods by sending discovery request
+     */
+    private discoverMethods;
+    /**
+     * Send a message to the child process
+     *
+     * Uses length-prefixed framing: [length:4 bytes][json message]
+     *
+     * @param message - Message to send
+     */
+    private sendMessage;
+    /**
+     * Handle incoming data from stdout
+     *
+     * Implements length-prefixed framing to extract complete messages.
+     *
+     * @param data - Raw data from stdout
+     */
+    private handleData;
+    /**
+     * Handle a parsed message
+     *
+     * @param message - Parsed message object
+     */
+    private handleMessage;
+    /**
+     * Handle process error
+     *
+     * @param error - Error from child process
+     */
+    private handleProcessError;
+    /**
+     * Handle process exit
+     *
+     * @param code - Exit code
+     * @param signal - Exit signal
+     */
+    private handleProcessExit;
+    /**
+     * Cleanup resources
+     */
+    private cleanup;
+}
+//# sourceMappingURL=StdioTransport.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"StdioTransport.d.ts","sourceRoot":"","sources":["../../src/transports/StdioTransport.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,KAAK,EACV,gBAAgB,EAChB,qBAAqB,EACrB,YAAY,EACb,MAAM,mBAAmB,CAAC;AAkB3B;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,cAAe,SAAQ,YAAa,YAAW,gBAAgB;IAC1E;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkC;IAE1D;;OAEG;IACH,OAAO,CAAC,OAAO,CAA6B;IAE5C;;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,eAAe,CAAmD;IAE1E;;OAEG;IACH,OAAO,CAAC,MAAM,CAAmB;IAEjC;;;;OAIG;gBACS,OAAO,EAAE,qBAAqB;IAc1C;;;;;;;;;;;;OAYG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAmE9B;;;;;;;;;;;;;;;;OAgBG;IACG,MAAM,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,EAC9C,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,OAAO,CAAC;IAiDnB;;;;OAIG;IACH,UAAU,IAAI,MAAM,EAAE;IAItB;;;;;OAKG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAIzD;;;;;;;;;OASG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IASjC;;;;;OAKG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI;IASpD;;OAEG;YACW,eAAe;IAgD7B;;;;;;OAMG;IACH,OAAO,CAAC,WAAW;IA8BnB;;;;;;OAMG;IACH,OAAO,CAAC,UAAU;IAiClB;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAsCrB;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAW1B;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;IAazB;;OAEG;IACH,OAAO,CAAC,OAAO;CA4BhB"}