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

package/dist/schemas/events.schemas.js.map

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

package/dist/schemas/index.d.ts

@@ -0,0 +1,3 @@
+export * from './kadi.schemas.js';
+export * from './events.schemas.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AACA,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC"}

package/dist/schemas/index.js

@@ -0,0 +1,4 @@
+// Export all schemas from a single entry point
+export * from './kadi.schemas.js';
+export * from './events.schemas.js';
+//# sourceMappingURL=index.js.map

package/dist/schemas/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC"}

package/dist/schemas/kadi.schemas.d.ts

@@ -0,0 +1,70 @@
+import { z } from 'zod';
+export declare const NetworkIdSchema: z.ZodString;
+export declare const ToolNameSchema: z.ZodString;
+export declare const ToolSchema: z.ZodObject<{
+    name: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    version: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    inputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    networks: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export declare const MailboxModeSchema: z.ZodEnum<{
+    volatile: "volatile";
+    persistent: "persistent";
+}>;
+export declare const AgentIdSchema: z.ZodString;
+export declare const KadiRegisterParamsSchema: z.ZodObject<{
+    tools: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        version: z.ZodOptional<z.ZodString>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        inputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        networks: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>>>;
+    displayName: z.ZodOptional<z.ZodString>;
+    mailboxMode: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+        volatile: "volatile";
+        persistent: "persistent";
+    }>>>;
+    networks: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>;
+    parentAgentId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type KadiRegisterParams = z.infer<typeof KadiRegisterParamsSchema>;
+export declare const KadiRegisterResultSchema: z.ZodObject<{
+    agentId: z.ZodString;
+    registered: z.ZodNumber;
+    networks: z.ZodArray<z.ZodString>;
+    mailbox: z.ZodString;
+    mailboxMode: z.ZodEnum<{
+        volatile: "volatile";
+        persistent: "persistent";
+    }>;
+}, z.core.$strip>;
+export type KadiRegisterResult = z.infer<typeof KadiRegisterResultSchema>;
+export declare const KadiToolListParamsSchema: z.ZodObject<{
+    networks: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type KadiToolListParams = z.infer<typeof KadiToolListParamsSchema>;
+export declare const KadiToolInvokeParamsSchema: z.ZodObject<{
+    toolName: z.ZodString;
+    toolInput: z.ZodOptional<z.ZodUnknown>;
+    requestId: z.ZodOptional<z.ZodString>;
+    timeout: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    metadata: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+}, z.core.$strip>;
+export type KadiToolInvokeParams = z.infer<typeof KadiToolInvokeParamsSchema>;
+export declare const KadiToolResultParamsSchema: z.ZodObject<{
+    requestId: z.ZodString;
+    result: z.ZodOptional<z.ZodUnknown>;
+    error: z.ZodOptional<z.ZodUnknown>;
+    metadata: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+}, z.core.$strip>;
+export type KadiToolResultParams = z.infer<typeof KadiToolResultParamsSchema>;
+export declare class ValidationMiddleware {
+    static validateParams<T>(method: string, params: unknown): T;
+}
+//# sourceMappingURL=kadi.schemas.d.ts.map

package/dist/schemas/kadi.schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kadi.schemas.d.ts","sourceRoot":"","sources":["../../src/schemas/kadi.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,eAAO,MAAM,eAAe,aAKK,CAAC;AAMlC,eAAO,MAAM,cAAc,aAmB2B,CAAC;AAGvD,eAAO,MAAM,UAAU;;;;;;;;iBAWrB,CAAC;AAGH,eAAO,MAAM,iBAAiB;;;EAAqC,CAAC;AAGpE,eAAO,MAAM,aAAa,aAKK,CAAC;AAOhC,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;iBAiBjC,CAAC;AAEL,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAG1E,eAAO,MAAM,wBAAwB;;;;;;;;;iBAMnC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAG1E,eAAO,MAAM,wBAAwB;;iBAEnC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAG1E,eAAO,MAAM,0BAA0B;;;;;;iBAMrC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAG9E,eAAO,MAAM,0BAA0B;;;;;iBAKrC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAM9E,qBAAa,oBAAoB;IAC/B,MAAM,CAAC,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,CAAC;CAc7D"}

package/dist/schemas/kadi.schemas.js

@@ -0,0 +1,120 @@
+import { z } from 'zod';
+// ============================================================================
+// NETWORK VALIDATION SCHEMAS
+// ============================================================================
+// Network ID validation
+export const NetworkIdSchema = z
+    .string()
+    .min(1)
+    .max(128)
+    .regex(/^[a-z0-9][a-z0-9-_.]*$/i)
+    .describe('Network identifier');
+// Tool name validation - Supports both legacy and namespaced formats
+// Namespaced format: <namespace>/<name>@<major>[.<minor>]
+// Legacy format: simple name (will be auto-normalized)
+// Examples: 'data/analyze_dataset@1', 'kadi/echo@1.0', 'legacy_tool'
+export const ToolNameSchema = z
+    .string()
+    .min(1)
+    .max(128)
+    .refine((val) => {
+    // Allow legacy format (simple names)
+    const legacyRegex = /^[a-zA-Z][a-zA-Z0-9_-]*$/;
+    // Strict namespaced format
+    const namespacedRegex = /^[a-z0-9][a-z0-9._-]*\/[a-z0-9][a-z0-9._-]*@\d+(?:\.\d+)?$/;
+    return legacyRegex.test(val) || namespacedRegex.test(val);
+}, {
+    message: 'Tool name must be either legacy format (alphanumeric) or namespaced format (<namespace>/<name>@<version>)'
+})
+    .describe('Tool name - legacy or namespaced format');
+// Tool schema with networks, namespace, and versioning
+export const ToolSchema = z.object({
+    name: ToolNameSchema, // Now supports namespace/name@version format
+    title: z.string().min(1).max(128).optional(), // Human-readable title
+    description: z.string().optional(),
+    version: z
+        .string()
+        .regex(/^\d+\.\d+\.\d+$/)
+        .optional(), // Semantic version
+    tags: z.array(z.string()).optional(), // Routing hints like ['cpu-heavy', 'batch']
+    inputSchema: z.record(z.string(), z.unknown()).optional(),
+    networks: z.array(NetworkIdSchema).optional()
+});
+// Mailbox mode validation
+export const MailboxModeSchema = z.enum(['volatile', 'persistent']);
+// Agent ID validation
+export const AgentIdSchema = z
+    .string()
+    .min(1)
+    .max(64)
+    .regex(/^[a-z0-9]+$/i)
+    .describe('Agent identifier');
+// ============================================================================
+// KADI PROTOCOL MESSAGE SCHEMAS
+// ============================================================================
+// Registration Schema - Updated to use 'networks' instead of 'scopes'
+export const KadiRegisterParamsSchema = z
+    .object({
+    tools: z.array(ToolSchema).optional().default([]),
+    displayName: z.string().min(1).max(64).optional(),
+    mailboxMode: MailboxModeSchema.optional().default('volatile'),
+    networks: z
+        .union([
+        // Changed from 'scopes'
+        NetworkIdSchema,
+        z.array(NetworkIdSchema)
+    ])
+        .transform((val) => (Array.isArray(val) ? val : [val])),
+    parentAgentId: AgentIdSchema.optional()
+})
+    .refine((data) => data.networks.length > 0, {
+    message: 'At least one network must be specified',
+    path: ['networks']
+});
+// Registration Result
+export const KadiRegisterResultSchema = z.object({
+    agentId: z.string(),
+    registered: z.number(),
+    networks: z.array(NetworkIdSchema),
+    mailbox: z.string(),
+    mailboxMode: MailboxModeSchema
+});
+// Tool List params - Changed from 'scopes'
+export const KadiToolListParamsSchema = z.object({
+    networks: z.array(NetworkIdSchema).optional() // Filter by networks
+});
+// Tool invocation params
+export const KadiToolInvokeParamsSchema = z.object({
+    toolName: ToolNameSchema,
+    toolInput: z.unknown().optional(),
+    requestId: z.string().optional(),
+    timeout: z.number().min(1000).max(300000).optional().default(30000),
+    metadata: z.record(z.string(), z.unknown()).optional().default({})
+});
+// Tool result params
+export const KadiToolResultParamsSchema = z.object({
+    requestId: z.string(),
+    result: z.unknown().optional(),
+    error: z.unknown().optional(),
+    metadata: z.record(z.string(), z.unknown()).optional().default({})
+});
+// ============================================================================
+// VALIDATION MIDDLEWARE
+// ============================================================================
+export class ValidationMiddleware {
+    static validateParams(method, params) {
+        switch (method) {
+            case 'kadi.agent.register':
+                return KadiRegisterParamsSchema.parse(params);
+            case 'kadi.ability.list':
+                return KadiToolListParamsSchema.parse(params);
+            case 'kadi.ability.invoke':
+                return KadiToolInvokeParamsSchema.parse(params);
+            case 'kadi.ability.result':
+                return KadiToolResultParamsSchema.parse(params);
+            default:
+                return params;
+        }
+    }
+}
+//# sourceMappingURL=kadi.schemas.js.map

package/dist/schemas/kadi.schemas.js.map

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

package/dist/transports/BrokerTransport.d.ts

@@ -0,0 +1,96 @@
+/**
+ * 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 { Transport, TransportOptions } from './Transport.js';
+/**
+ * Options specific to BrokerTransport
+ */
+interface BrokerTransportOptions extends TransportOptions {
+    /**
+     * The target agent name we want to call methods on
+     * This is the remote agent that has the methods we want to invoke
+     */
+    targetAgent: string;
+    /**
+     * WebSocket URL of the broker
+     */
+    brokerUrl: string;
+    /**
+     * Networks to join for discovering agents
+     */
+    networks?: string[];
+    /**
+     * Whether to spawn the ability locally first (not used for client-only mode)
+     */
+    spawnAbility?: boolean;
+}
+/**
+ * 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 declare class BrokerTransport extends EventEmitter implements Transport {
+    private options;
+    private logger;
+    private client?;
+    private targetAgent;
+    private connected;
+    constructor(options: BrokerTransportOptions);
+    /**
+     * 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).
+     */
+    connect(): Promise<void>;
+    /**
+     * Invoke a method on the remote agent
+     *
+     * Sends the method invocation through the broker to the target agent.
+     */
+    invoke(method: string, params: unknown): Promise<unknown>;
+    /**
+     * Get list of discovered methods
+     *
+     * Returns empty array as broker transport doesn't do method discovery.
+     */
+    getMethods(): string[];
+    /**
+     * Disconnect from the broker
+     *
+     * Closes the WebSocket connection and cleans up resources.
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Check if transport is connected
+     */
+    isConnected(): boolean;
+    /**
+     * Get the target agent name
+     *
+     * Useful for debugging and logging
+     */
+    getTargetAgent(): string;
+}
+export {};
+//# 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;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAI7D;;GAEG;AACH,UAAU,sBAAuB,SAAQ,gBAAgB;IACvD;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpB;;OAEG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;;;;;;;GASG;AACH,qBAAa,eAAgB,SAAQ,YAAa,YAAW,SAAS;IAMxD,OAAO,CAAC,OAAO;IAL3B,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,MAAM,CAAC,CAAa;IAC5B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,SAAS,CAAS;gBAEN,OAAO,EAAE,sBAAsB;IAWnD;;;;;OAKG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAqD9B;;;;OAIG;IACG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IA2B/D;;;;OAIG;IACH,UAAU,IAAI,MAAM,EAAE;IAItB;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAajC;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;;;OAIG;IACH,cAAc,IAAI,MAAM;CAGzB"}

package/dist/transports/BrokerTransport.js

@@ -0,0 +1,145 @@
+/**
+ * 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 { KadiClient } from '../KadiClient.js';
+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');
+        this.logger.lifecycle('constructor', `Creating broker transport for target: ${this.targetAgent}`);
+    }
+    /**
+     * 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}`);
+        // Create an ephemeral client with a unique name
+        // This client doesn't serve any methods - it's just for calling remote methods
+        this.client = new KadiClient({
+            name: `client-for-${this.targetAgent}-${Date.now()}`,
+            role: 'agent',
+            protocol: 'broker',
+            networks: this.options.networks || ['global'],
+            brokerUrls: [this.options.brokerUrl]
+        });
+        // Forward events from the client
+        this.client.on('connected', () => {
+            this.logger.debug('connect', 'KadiClient connected to broker');
+        });
+        this.client.on('error', (error) => {
+            this.logger.error('connect', 'KadiClient error', error);
+            this.emit('error', error);
+        });
+        this.client.on('disconnected', () => {
+            this.logger.debug('connect', 'KadiClient disconnected from broker');
+            this.connected = false;
+            this.emit('disconnected');
+        });
+        try {
+            // Connect to the broker
+            await this.client.connectToBrokers([this.options.brokerUrl]);
+            this.logger.info('connect', `Connected to broker at ${this.options.brokerUrl}`);
+            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
+     *
+     * Closes the WebSocket connection and cleans up resources.
+     */
+    async disconnect() {
+        this.logger.lifecycle('disconnect', 'Disconnecting broker transport');
+        if (this.client) {
+            await this.client.disconnect();
+            this.client = undefined;
+        }
+        this.connected = false;
+        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,92 @@
+/**
+ * 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;
+    /**
+     * Manifest containing ability metadata
+     */
+    manifest?: {
+        interfaces?: {
+            native?: {
+                entry?: 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 dynamically imports the ability's JavaScript/TypeScript
+     * module and extracts all available methods.
+     */
+    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;AAIH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAI7D;;GAEG;AACH,UAAU,sBAAuB,SAAQ,gBAAgB;IACvD;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,QAAQ,CAAC,EAAE;QACT,UAAU,CAAC,EAAE;YACX,MAAM,CAAC,EAAE;gBACP,KAAK,CAAC,EAAE,MAAM,CAAC;aAChB,CAAC;SACH,CAAC;KACH,CAAC;CACH;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;IA4D9B;;;;;;;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;IAUjC;;OAEG;IACH,WAAW,IAAI,OAAO;CAGvB"}