@kadi.build/core 0.0.1-alpha.3 → 0.0.1-alpha.4

package/dist/transports/NativeTransport.js

@@ -0,0 +1,221 @@
+/**
+ * NativeTransport - Handles direct in-process ability loading
+ *
+ * This transport loads abilities directly into the same process,
+ * allowing for zero-overhead method invocation. It's used when
+ * you want to load local JavaScript/TypeScript modules as abilities.
+ *
+ * The native protocol is the fastest but requires the ability code
+ * to be trusted since it runs in the same process.
+ */
+import path from 'node:path';
+import fs from 'node:fs';
+import { EventEmitter } from 'events';
+import { createComponentLogger } from '../utils/logger.js';
+import { getAbilityJSON } from '../utils/agentUtils.js';
+/**
+ * NativeTransport - Loads and executes abilities in the same process
+ *
+ * This transport provides the fastest execution since there's no
+ * serialization or IPC overhead. The ability code runs directly
+ * in the Node.js process.
+ */
+export class NativeTransport extends EventEmitter {
+    options;
+    logger;
+    ability;
+    methodHandlers = new Map();
+    connected = false;
+    constructor(options) {
+        super();
+        this.options = options;
+        this.logger = createComponentLogger('NativeTransport');
+        this.logger.lifecycle('constructor', `Creating native transport for ${options.abilityName}`);
+    }
+    /**
+     * Connect by loading the ability module into memory
+     *
+     * This method dynamically imports the ability's JavaScript/TypeScript
+     * module and extracts all available methods.
+     */
+    async connect() {
+        const { abilityName, abilityVersion, abilityDir, manifest } = this.options;
+        this.logger.lifecycle('connect', `Loading ${abilityName} as native module`);
+        // Determine entry point for the ability
+        const entryFromManifest = manifest?.interfaces?.native?.entry;
+        let entryRelPath = entryFromManifest;
+        // Fallback to checking agent.json or package.json
+        if (!entryRelPath) {
+            const moduleJSON = getAbilityJSON(abilityName, abilityVersion || '1.0.0');
+            entryRelPath = moduleJSON?.entry || moduleJSON?.main || 'index.js';
+        }
+        if (!entryRelPath) {
+            throw new Error(`Ability '${abilityName}' is missing entry point configuration`);
+        }
+        const modulePath = path.join(abilityDir, entryRelPath);
+        if (!fs.existsSync(modulePath)) {
+            throw new Error(`Ability '${abilityName}' entry file not found: ${modulePath}`);
+        }
+        this.logger.debug('connect', `Loading module from: ${modulePath}`);
+        // Set environment variable so the module knows it's being loaded via native protocol
+        const originalProtocol = process.env.KADI_PROTOCOL;
+        process.env.KADI_PROTOCOL = 'native';
+        let rawModule;
+        try {
+            // Dynamic import of the ability
+            const mod = await import(modulePath);
+            rawModule = mod.default || mod;
+        }
+        finally {
+            // Restore original environment
+            if (originalProtocol !== undefined) {
+                process.env.KADI_PROTOCOL = originalProtocol;
+            }
+            else {
+                delete process.env.KADI_PROTOCOL;
+            }
+        }
+        // Extract methods based on the module export format
+        await this.extractMethods(rawModule, abilityName);
+        this.connected = true;
+        this.logger.lifecycle('connect', 'Native ability loaded successfully');
+        this.emit('connected');
+    }
+    /**
+     * Extract methods from the loaded module
+     *
+     * Handles different export formats:
+     * - KadiClient/KadiAbility instances
+     * - Plain objects with function properties
+     * - Class constructors
+     */
+    async extractMethods(rawModule, abilityName) {
+        if (typeof rawModule === 'object' && rawModule !== null) {
+            // Check if this is a KadiClient or KadiAbility instance
+            if (rawModule.constructor?.name === 'KadiClient' ||
+                rawModule.constructor?.name === 'KadiAbility' ||
+                typeof rawModule.getToolNames === 'function') {
+                this.logger.debug('extractMethods', 'Detected KadiClient/KadiAbility instance');
+                // Extract methods from KadiClient/KadiAbility
+                const methodNames = rawModule.getToolNames();
+                for (const methodName of methodNames) {
+                    const handler = rawModule.getToolHandler(methodName);
+                    if (handler) {
+                        this.methodHandlers.set(methodName, handler);
+                    }
+                }
+                this.ability = rawModule;
+                // Forward events if the ability supports them
+                if (typeof rawModule.on === 'function') {
+                    /**
+                     * Listen for the internal transport event from the loaded ability.
+                     * KadiClient instances emit __KADI_INTERNAL_ABILITY_EVENT_TRANSPORT__ when
+                     * they publish events in native mode. We catch these and forward them
+                     * to the AbilityProxy as regular 'event' emissions.
+                     */
+                    const ABILITY_EVENT_TRANSPORT = '__KADI_INTERNAL_ABILITY_EVENT_TRANSPORT__';
+                    this.logger.trace('extractMethods', `Setting up ${ABILITY_EVENT_TRANSPORT} listener on rawModule`);
+                    rawModule.on(ABILITY_EVENT_TRANSPORT, (eventData) => {
+                        this.logger.trace('extractMethods', `Received ${ABILITY_EVENT_TRANSPORT} from rawModule: ${JSON.stringify(eventData)}`);
+                        this.logger.debug('extractMethods', 'Emitting event on transport');
+                        this.emit('event', eventData);
+                    });
+                }
+                else {
+                    this.logger.debug('extractMethods', 'rawModule does not support .on() method');
+                }
+            }
+            else {
+                // Plain object with methods as properties
+                this.logger.debug('extractMethods', 'Processing plain object with methods');
+                for (const [key, value] of Object.entries(rawModule)) {
+                    if (typeof value === 'function' && !key.startsWith('_')) {
+                        this.methodHandlers.set(key, value);
+                    }
+                }
+                this.ability = rawModule;
+            }
+        }
+        else if (typeof rawModule === 'function') {
+            // Class constructor - instantiate and extract methods
+            this.logger.debug('extractMethods', 'Processing class constructor');
+            const instance = new rawModule();
+            const prototype = Object.getPrototypeOf(instance);
+            const methodNames = Object.getOwnPropertyNames(prototype).filter((name) => name !== 'constructor' &&
+                !name.startsWith('_') &&
+                typeof prototype[name] === 'function');
+            for (const name of methodNames) {
+                const method = instance[name];
+                if (typeof method === 'function') {
+                    this.methodHandlers.set(name, method.bind(instance));
+                }
+            }
+            this.ability = instance;
+        }
+        else {
+            throw new Error(`Unsupported module export type for ability '${abilityName}'`);
+        }
+        this.logger.info('extractMethods', `Extracted ${this.methodHandlers.size} methods from ${abilityName}`);
+    }
+    /**
+     * Invoke a method on the loaded ability
+     *
+     * Since this is native, we just call the function directly
+     * with no serialization overhead.
+     */
+    async invoke(method, params) {
+        if (!this.connected) {
+            throw new Error('Native ability not loaded');
+        }
+        this.logger.trace('invoke', `Invoking method: ${method}`);
+        const handler = this.methodHandlers.get(method);
+        if (!handler) {
+            throw new Error(`Method '${method}' not found in native ability`);
+        }
+        try {
+            // Direct function call - no serialization needed
+            const result = await handler(params);
+            this.logger.trace('invoke', `Method ${method} completed successfully`);
+            return result;
+        }
+        catch (error) {
+            this.logger.error('invoke', `Method ${method} failed: ${error}`);
+            throw error;
+        }
+    }
+    /**
+     * Get list of available methods
+     */
+    getMethods() {
+        return Array.from(this.methodHandlers.keys());
+    }
+    /**
+     * Get schema for a specific method (if available)
+     */
+    getMethodSchema(method) {
+        // If the ability is a KadiClient/KadiAbility, it might have schema info
+        if (this.ability && typeof this.ability.getMethodSchema === 'function') {
+            return this.ability.getMethodSchema(method);
+        }
+        return undefined;
+    }
+    /**
+     * Disconnect and cleanup
+     *
+     * Releases references to the loaded module to allow garbage collection
+     */
+    async disconnect() {
+        this.logger.lifecycle('disconnect', 'Disconnecting native transport');
+        this.ability = undefined;
+        this.methodHandlers.clear();
+        this.connected = false;
+        this.emit('disconnected');
+    }
+    /**
+     * Check if transport is connected
+     */
+    isConnected() {
+        return this.connected;
+    }
+}
+//# 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,112 @@
+/**
+ * StdioTransport - Handles stdio communication for abilities
+ *
+ * This transport operates in two modes:
+ *
+ * CLIENT MODE: Spawns an ability as a child process and calls its methods
+ * - Parent process sends JSON-RPC requests to child's stdin
+ * - Child process sends JSON-RPC responses back via stdout
+ *
+ * SERVER MODE: Serves an ability's methods via stdio (when running as a child)
+ * - Reads JSON-RPC requests from stdin
+ * - Writes JSON-RPC responses to stdout
+ *
+ * Both modes use LSP-style message framing for reliable communication.
+ * The transport handles all the complexity of:
+ * - Process spawning and lifecycle management (client mode)
+ * - Message framing and buffering
+ * - Request/response correlation
+ * - Timeout handling
+ */
+import { EventEmitter } from 'events';
+import { Transport, TransportOptions } from './Transport.js';
+/**
+ * Options specific to StdioTransport
+ */
+interface StdioTransportOptions extends TransportOptions {
+    /**
+     * Directory where the ability code is located
+     */
+    abilityDir: string;
+    /**
+     * Command to start the ability process
+     */
+    startCmd: string;
+    /**
+     * Optional manifest with configuration
+     */
+    manifest?: {
+        interface?: {
+            timeoutMs?: number;
+        };
+    };
+}
+/**
+ * StdioTransport - Manages child process abilities via stdio
+ *
+ * This transport provides process isolation and language independence.
+ * The ability runs in a separate process and can be written in any
+ * language that supports JSON-RPC over stdio.
+ */
+export declare class StdioTransport extends EventEmitter implements Transport {
+    private options;
+    private logger;
+    private process?;
+    private reader?;
+    private writer?;
+    private connected;
+    private pending;
+    private nextId;
+    constructor(options: StdioTransportOptions);
+    /**
+     * Connect by spawning the child process
+     *
+     * This method spawns the ability as a child process and sets up
+     * the stdio communication channels.
+     */
+    connect(): Promise<void>;
+    /**
+     * Handle incoming message from child process
+     */
+    private handleMessage;
+    /**
+     * Invoke a method on the child process ability
+     *
+     * Sends a JSON-RPC request to the child and waits for the response.
+     */
+    invoke(method: string, params: unknown): Promise<unknown>;
+    /**
+     * Get list of available methods
+     */
+    getMethods(): string[];
+    /**
+     * Disconnect and cleanup
+     *
+     * Terminates the child process and cleans up resources.
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Cleanup resources
+     */
+    private cleanup;
+    /**
+     * Check if transport is connected
+     */
+    isConnected(): boolean;
+    /**
+     * Publish an event to the parent process (when serving as child)
+     */
+    publishEvent(eventName: string, data: unknown): void;
+    /**
+     * Serve an ability via stdio (server mode)
+     *
+     * This method is used when the transport needs to serve an ability's methods
+     * via stdio (when running as a child process). It reads JSON-RPC requests
+     * from stdin and writes responses to stdout.
+     *
+     * @param ability - The ability (KadiClient) to serve
+     */
+    serve(ability: any): Promise<void>;
+}
+export {};
+//# 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;;;;;;;;;;;;;;;;;;;GAmBG;AAKH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAS7D;;GAEG;AACH,UAAU,qBAAsB,SAAQ,gBAAgB;IACtD;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,QAAQ,CAAC,EAAE;QACT,SAAS,CAAC,EAAE;YACV,SAAS,CAAC,EAAE,MAAM,CAAC;SACpB,CAAC;KACH,CAAC;CACH;AAuKD;;;;;;GAMG;AACH,qBAAa,cAAe,SAAQ,YAAa,YAAW,SAAS;IASvD,OAAO,CAAC,OAAO;IAR3B,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,OAAO,CAAC,CAAe;IAC/B,OAAO,CAAC,MAAM,CAAC,CAAc;IAC7B,OAAO,CAAC,MAAM,CAAC,CAAc;IAC7B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,OAAO,CAA8C;IAC7D,OAAO,CAAC,MAAM,CAAK;gBAEC,OAAO,EAAE,qBAAqB;IAUlD;;;;;OAKG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAwE9B;;OAEG;IACH,OAAO,CAAC,aAAa;IAoCrB;;;;OAIG;IACG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAsC/D;;OAEG;IACH,UAAU,IAAI,MAAM,EAAE;IAItB;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAkBjC;;OAEG;IACH,OAAO,CAAC,OAAO;IAcf;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI;IA+BpD;;;;;;;;OAQG;IACG,KAAK,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;CAuEzC"}