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

package/dist/transports/BrokerTransport.js

@@ -0,0 +1,177 @@
+/**
+ * BrokerTransport - Handles communication with remote abilities via broker
+ *
+ * This transport connects to a broker (WebSocket server) to invoke methods
+ * on remote agents/abilities. Unlike Native and Stdio transports which load
+ * local code, BrokerTransport is purely a client that calls remote services.
+ *
+ * The broker acts as a message router, allowing agents to discover and
+ * invoke each other's methods across network boundaries.
+ *
+ * Communication Flow:
+ * 1. Connect to broker via WebSocket
+ * 2. Authenticate and join networks
+ * 3. Discover available methods from target agent
+ * 4. Send method invocations through broker
+ * 5. Receive results back through broker
+ */
+import { EventEmitter } from 'events';
+import { createComponentLogger } from '../utils/logger.js';
+/**
+ * BrokerTransport - Client for invoking methods on remote agents
+ *
+ * This transport is a thin wrapper around KadiClient's broker functionality.
+ * It creates an ephemeral KadiClient instance that connects to the broker
+ * solely for the purpose of calling methods on a remote agent.
+ *
+ * Unlike serving mode (where an agent registers its own methods),
+ * this transport is purely a consumer of remote methods.
+ */
+export class BrokerTransport extends EventEmitter {
+    options;
+    logger;
+    client;
+    targetAgent;
+    connected = false;
+    constructor(options) {
+        super();
+        this.options = options;
+        this.targetAgent = options.targetAgent || options.abilityName;
+        this.logger = createComponentLogger('BrokerTransport');
+        if (!options.existingClient) {
+            throw new Error('BrokerTransport requires an existing KadiClient');
+        }
+        this.client = options.existingClient;
+        this.logger.lifecycle('constructor', `Creating broker transport for target: ${this.targetAgent} using existing client`);
+    }
+    /**
+     * Connect to the broker and discover target agent's methods
+     *
+     * This creates an ephemeral KadiClient that connects to the broker
+     * as a client (not serving any methods of its own).
+     */
+    async connect() {
+        this.logger.lifecycle('connect', `Connecting to broker for target agent: ${this.targetAgent}`);
+        try {
+            // Connect to specific broker if not already connected
+            const brokerUrl = this.options.brokerUrl;
+            if (!brokerUrl) {
+                throw new Error('Broker URL is required for BrokerTransport');
+            }
+            // Check if we're already connected to this specific broker
+            const isConnectedToRightBroker = this.client.isConnectedToBroker(brokerUrl);
+            if (!isConnectedToRightBroker) {
+                // Need to connect to the specific broker
+                this.logger.info('connect', `Connecting to specific broker: ${brokerUrl}`);
+                // Connect only to the specific broker requested
+                await this.client.connectToBroker(brokerUrl, this.options.brokerName);
+            }
+            else {
+                this.logger.info('connect', `Already connected to broker: ${brokerUrl}`);
+            }
+            // OLD CODE - Connect to all brokers
+            // await this.client.connectToBrokers();
+            this.logger.info('connect', `Connected to broker at ${this.options.brokerUrl}`);
+            // Discover available tools in the network to verify target exists
+            this.logger.debug('connect', `Discovering tools in network to verify ${this.targetAgent} exists`);
+            const toolsResponse = await this.client.sendBrokerRequest('kadi.ability.list', {
+                networks: this.client.networks || ['global'],
+                includeProviders: true
+            });
+            // Check if any tools are provided by an agent matching our target name
+            const tools = toolsResponse.tools || [];
+            const targetProviders = new Set();
+            const availableAgents = new Set();
+            for (const tool of tools) {
+                if (tool.providers) {
+                    for (const provider of tool.providers) {
+                        // Track all available agents for error message (prefer displayName)
+                        const agentName = provider.displayName || provider.agentId;
+                        availableAgents.add(agentName);
+                        // Check if this provider matches our target
+                        // Match by displayName or if the targetAgent appears to be an agentId
+                        if (provider.displayName === this.targetAgent ||
+                            provider.agentId === this.targetAgent) {
+                            targetProviders.add(provider.agentId);
+                        }
+                    }
+                }
+            }
+            if (targetProviders.size === 0) {
+                const networks = this.client.networks || ['global'];
+                const availableList = Array.from(availableAgents).sort();
+                throw new Error(`Ability '${this.targetAgent}' not found in networks [${networks.join(', ')}].\n` +
+                    `Available abilities in these networks:\n${availableList.map((a) => `  - ${a}`).join('\n')}\n\n` +
+                    `Make sure the ability is running and connected to the broker.`);
+            }
+            this.logger.info('connect', `Found ${this.targetAgent} in network with ${targetProviders.size} provider(s)`);
+            this.connected = true;
+            this.logger.lifecycle('connect', `Broker transport connected to ${this.targetAgent}`);
+            this.emit('connected');
+        }
+        catch (error) {
+            this.logger.error('connect', `Failed to connect to broker: ${error}`);
+            throw error;
+        }
+    }
+    /**
+     * Invoke a method on the remote agent
+     *
+     * Sends the method invocation through the broker to the target agent.
+     */
+    async invoke(method, params) {
+        if (!this.connected || !this.client) {
+            throw new Error('Not connected to broker');
+        }
+        this.logger.trace('invoke', `Invoking ${this.targetAgent}.${method}`);
+        try {
+            // Use KadiClient's remote tool invocation
+            const result = await this.client.callTool(this.targetAgent, method, params);
+            this.logger.trace('invoke', `Method ${method} completed successfully`);
+            return result;
+        }
+        catch (error) {
+            this.logger.error('invoke', `Failed to invoke ${this.targetAgent}.${method}: ${error}`);
+            throw error;
+        }
+    }
+    /**
+     * Get list of discovered methods
+     *
+     * Returns empty array as broker transport doesn't do method discovery.
+     */
+    getMethods() {
+        return [];
+    }
+    /**
+     * Disconnect from the broker
+     *
+     * Since we're reusing an existing client, we don't actually disconnect it
+     * (other parts of the app might still be using it)
+     */
+    async disconnect() {
+        this.logger.lifecycle('disconnect', 'Disconnecting broker transport');
+        // Don't disconnect the shared client - just mark ourselves as disconnected
+        // The client is managed by the main application
+        this.connected = false;
+        if (this.client) {
+            await this.client.disconnect();
+        }
+        this.emit('disconnected');
+    }
+    /**
+     * Check if transport is connected
+     */
+    isConnected() {
+        return this.connected;
+    }
+    /**
+     * Get the target agent name
+     *
+     * Useful for debugging and logging
+     */
+    getTargetAgent() {
+        return this.targetAgent;
+    }
+}
+//# 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,82 @@
+/**
+ * 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 { EventEmitter } from 'events';
+import { Transport, TransportOptions } from './Transport.js';
+/**
+ * Options specific to NativeTransport
+ */
+interface NativeTransportOptions extends TransportOptions {
+    /**
+     * Directory where the ability code is located
+     */
+    abilityDir: string;
+}
+/**
+ * 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 declare class NativeTransport extends EventEmitter implements Transport {
+    private options;
+    private logger;
+    private ability;
+    private methodHandlers;
+    private connected;
+    constructor(options: NativeTransportOptions);
+    /**
+     * Connect by loading the ability module into memory
+     *
+     * This method uses JavaScript's native import to load the ability,
+     * delegating all module resolution complexity to Node.js itself.
+     */
+    connect(): Promise<void>;
+    /**
+     * Extract methods from the loaded module
+     *
+     * Handles different export formats:
+     * - KadiClient/KadiAbility instances
+     * - Plain objects with function properties
+     * - Class constructors
+     */
+    private extractMethods;
+    /**
+     * Invoke a method on the loaded ability
+     *
+     * Since this is native, we just call the function directly
+     * with no serialization overhead.
+     */
+    invoke(method: string, params: unknown): Promise<unknown>;
+    /**
+     * Get list of available methods
+     */
+    getMethods(): string[];
+    /**
+     * Get schema for a specific method (if available)
+     */
+    getMethodSchema(method: string): {
+        inputSchema?: unknown;
+        outputSchema?: unknown;
+    } | undefined;
+    /**
+     * Disconnect and cleanup
+     *
+     * Releases references to the loaded module to allow garbage collection
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Check if transport is connected
+     */
+    isConnected(): boolean;
+}
+export {};
+//# 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;;;;;;;;;GASG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAG7D;;GAEG;AACH,UAAU,sBAAuB,SAAQ,gBAAgB;IACvD;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;CAEpB;AAOD;;;;;;GAMG;AACH,qBAAa,eAAgB,SAAQ,YAAa,YAAW,SAAS;IAMxD,OAAO,CAAC,OAAO;IAL3B,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,OAAO,CAAM;IACrB,OAAO,CAAC,cAAc,CAAoC;IAC1D,OAAO,CAAC,SAAS,CAAS;gBAEN,OAAO,EAAE,sBAAsB;IAUnD;;;;;OAKG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA+F9B;;;;;;;OAOG;YACW,cAAc;IAoG5B;;;;;OAKG;IACG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAuB/D;;OAEG;IACH,UAAU,IAAI,MAAM,EAAE;IAItB;;OAEG;IACH,eAAe,CACb,MAAM,EAAE,MAAM,GACb;QAAE,WAAW,CAAC,EAAE,OAAO,CAAC;QAAC,YAAY,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,SAAS;IAQhE;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAoBjC;;OAEG;IACH,WAAW,IAAI,OAAO;CAGvB"}

package/dist/transports/NativeTransport.js

@@ -0,0 +1,263 @@
+/**
+ * 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 { EventEmitter } from 'events';
+import { createComponentLogger } from '../utils/logger.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 uses JavaScript's native import to load the ability,
+     * delegating all module resolution complexity to Node.js itself.
+     */
+    async connect() {
+        const { abilityName, abilityDir } = this.options;
+        this.logger.lifecycle('connect', `Loading ${abilityName} as native module`);
+        this.logger.debug('connect', `abilityDir received: ${abilityDir}`);
+        this.logger.debug('connect', `process.cwd(): ${process.cwd()}`);
+        // 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 {
+            // Convert to absolute path if needed
+            const baseDir = path.isAbsolute(abilityDir)
+                ? abilityDir
+                : path.resolve(process.cwd(), abilityDir);
+            // Resolve the actual entry file
+            // ES modules require importing a file, not a directory
+            let entryFile;
+            // Check for package.json main field
+            const packageJsonPath = path.join(baseDir, 'package.json');
+            try {
+                const fs = await import('node:fs');
+                const packageJson = JSON.parse(fs.default.readFileSync(packageJsonPath, 'utf-8'));
+                if (packageJson.main) {
+                    entryFile = path.join(baseDir, packageJson.main);
+                    this.logger.debug('connect', `Using package.json main: ${packageJson.main}`);
+                }
+                else {
+                    throw new Error('No main field in package.json');
+                }
+            }
+            catch (error) {
+                // Fallback to common entry points
+                const fs = await import('node:fs');
+                const commonEntries = ['service.js', 'index.js', 'index.mjs'];
+                entryFile = '';
+                for (const entry of commonEntries) {
+                    const testPath = path.join(baseDir, entry);
+                    if (fs.default.existsSync(testPath)) {
+                        entryFile = testPath;
+                        this.logger.debug('connect', `Using fallback entry: ${entry}`);
+                        break;
+                    }
+                }
+                if (!entryFile) {
+                    throw new Error(`No entry point found in ${baseDir}`);
+                }
+            }
+            this.logger.debug('connect', `Importing from: ${entryFile}`);
+            // Import the actual file
+            const mod = await import(entryFile);
+            rawModule = mod.default || mod;
+            this.logger.debug('connect', `Successfully imported module`);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.logger.error('connect', `Failed to import ability: ${errorMessage}`);
+            // Provide helpful error message
+            throw new Error(`Cannot load ability '${abilityName}' from ${abilityDir}. ` +
+                `Make sure the ability has either:\n` +
+                `  1. A package.json with a "main" field pointing to the entry file\n` +
+                `  2. An index.js file in the root directory\n` +
+                `Original error: ${errorMessage}`);
+        }
+        finally {
+            // Restore original environment
+            if (originalProtocol !== undefined) {
+                process.env.KADI_PROTOCOL = originalProtocol;
+            }
+            else {
+                delete process.env.KADI_PROTOCOL;
+            }
+        }
+        // Extract methods from the imported module
+        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');
+        // Call the ability's disconnect method if it exists
+        // This is crucial for native abilities to clean up properly.
+        // When an ability is loaded natively, it may have called serve()
+        // which creates a promise keeping the process alive. Calling
+        // disconnect() on the ability resolves that promise.
+        if (this.ability && typeof this.ability.disconnect === 'function') {
+            this.logger.debug('disconnect', 'Calling ability disconnect method');
+            await this.ability.disconnect();
+        }
+        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;IAgF9B;;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;IAmBjC;;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"}