@kadi.build/core 0.0.1-alpha.9 → 0.1.0

package/dist/transports/broker.js

@@ -0,0 +1,383 @@
+/**
+ * Broker transport for kadi-core v0.1.0
+ *
+ * Loads abilities that run on REMOTE agents connected to a broker.
+ * Communication happens via WebSocket using JSON-RPC.
+ *
+ * Protocol flow for invoking a remote tool:
+ * 1. Client sends kadi.ability.request → broker returns { status: 'pending', requestId }
+ * 2. Broker forwards request to provider agent
+ * 3. Provider executes tool and sends result back to broker
+ * 4. Broker sends kadi.ability.response notification with the actual result
+ *
+ * This transport doesn't manage the broker connection itself.
+ * It receives a BrokerState from KadiClient and uses it for communication.
+ *
+ * ═══════════════════════════════════════════════════════════════════════════════
+ * WORKAROUND NOTE: Ability Discovery
+ * ═══════════════════════════════════════════════════════════════════════════════
+ *
+ * The current broker is TOOL-CENTRIC (tracks tools, not abilities). There's no
+ * direct API to ask "What tools does agent X provide?"
+ *
+ * CURRENT WORKAROUND:
+ * 1. Call kadi.ability.list with includeProviders: true (fetches ALL tools)
+ * 2. Filter tools where provider.displayName matches the ability name
+ * 3. Use the provider's agentId for routing via _kadi hints
+ *
+ * FUTURE: When the broker implements kadi.agent.discover (see design doc at
+ * kadi-broker/docs/design/ABILITY_CENTRIC_DISCOVERY.md), replace the
+ * discoverAbilityWorkaround() function with a direct API call.
+ * ═══════════════════════════════════════════════════════════════════════════════
+ */
+import { KadiError } from '../errors.js';
+// ═══════════════════════════════════════════════════════════════════════════════
+// REQUEST HELPERS
+// ═══════════════════════════════════════════════════════════════════════════════
+/**
+ * Send a JSON-RPC request over WebSocket and wait for response.
+ *
+ * This is a low-level helper used by both discovery and invoke.
+ * The broker connection's pendingRequests map is used to match responses.
+ */
+async function sendBrokerRequest(broker, method, params, timeoutMs) {
+    // Verify connection is active
+    if (!broker.ws || broker.status !== 'connected') {
+        throw new KadiError(`Broker "${broker.name}" is not connected`, 'BROKER_NOT_CONNECTED', {
+            broker: broker.name,
+            status: broker.status,
+            hint: 'Call client.connect() first',
+        });
+    }
+    // Generate unique request ID
+    const id = `${Date.now()}-${Math.random().toString(36).slice(2, 9)}`;
+    // Build JSON-RPC request
+    const request = {
+        jsonrpc: '2.0',
+        id,
+        method,
+        params,
+    };
+    // Create promise that will be resolved when response arrives
+    return new Promise((resolve, reject) => {
+        // Set up timeout
+        const timeout = setTimeout(() => {
+            broker.pendingRequests.delete(id);
+            reject(new KadiError(`Request "${method}" timed out after ${timeoutMs}ms`, 'BROKER_TIMEOUT', {
+                broker: broker.name,
+                method,
+                timeout: timeoutMs,
+            }));
+        }, timeoutMs);
+        // Store in pending requests map
+        // The message handler in client.ts will resolve this when response arrives
+        broker.pendingRequests.set(id, {
+            resolve: (result) => {
+                clearTimeout(timeout);
+                resolve(result);
+            },
+            reject: (error) => {
+                clearTimeout(timeout);
+                reject(error);
+            },
+            timeout,
+            method,
+            sentAt: new Date(),
+        });
+        // Re-check connection before sending (could have disconnected during setup)
+        const ws = broker.ws;
+        if (!ws || broker.status !== 'connected') {
+            broker.pendingRequests.delete(id);
+            clearTimeout(timeout);
+            reject(new KadiError(`Broker "${broker.name}" disconnected`, 'BROKER_NOT_CONNECTED', {
+                broker: broker.name,
+            }));
+            return;
+        }
+        // Send the request
+        try {
+            ws.send(JSON.stringify(request));
+        }
+        catch (error) {
+            broker.pendingRequests.delete(id);
+            clearTimeout(timeout);
+            reject(new KadiError(`Failed to send request to broker "${broker.name}"`, 'BROKER_ERROR', {
+                broker: broker.name,
+                method,
+                reason: error instanceof Error ? error.message : String(error),
+            }));
+        }
+    });
+}
+// ═══════════════════════════════════════════════════════════════════════════════
+// ABILITY DISCOVERY (WORKAROUND)
+// ═══════════════════════════════════════════════════════════════════════════════
+/**
+ * Discover an ability on the broker by name.
+ *
+ * ┌─────────────────────────────────────────────────────────────────────────────┐
+ * │ WORKAROUND: This function uses kadi.ability.list + client-side filtering   │
+ * │                                                                             │
+ * │ The broker is currently tool-centric and doesn't support querying by       │
+ * │ agent/ability name directly. This workaround:                               │
+ * │                                                                             │
+ * │ 1. Fetches ALL tools with provider information                             │
+ * │ 2. Filters to find tools where provider.displayName matches abilityName    │
+ * │ 3. Extracts the agentId for consistent routing                             │
+ * │                                                                             │
+ * │ TODO: Replace with kadi.agent.discover when broker supports it.            │
+ * │ See: kadi-broker/docs/design/ABILITY_CENTRIC_DISCOVERY.md                  │
+ * └─────────────────────────────────────────────────────────────────────────────┘
+ *
+ * @param broker - The broker connection to query
+ * @param abilityName - Name of the ability/agent to find (matches displayName)
+ * @param options - Discovery options (timeout)
+ * @returns Information about the discovered ability
+ * @throws KadiError if ability not found
+ */
+async function discoverAbilityWorkaround(broker, abilityName, options) {
+    // Step 1: Fetch all tools with provider information
+    // This is inefficient but necessary until the broker supports agent queries
+    const response = (await sendBrokerRequest(broker, 'kadi.ability.list', { includeProviders: true }, options.timeoutMs));
+    if (!response?.tools) {
+        throw new KadiError(`Failed to list tools from broker "${broker.name}"`, 'BROKER_ERROR', { broker: broker.name });
+    }
+    // Step 2: Filter tools to find those provided by the named agent
+    // We match on provider.displayName (the agent's name from registration)
+    const matchingTools = [];
+    let targetAgentId;
+    let targetDisplayName;
+    for (const tool of response.tools) {
+        if (!tool.providers)
+            continue;
+        // Find a provider whose displayName matches our ability name
+        const matchingProvider = tool.providers.find((p) => p.displayName === abilityName);
+        if (matchingProvider) {
+            // Extract the agentId (stable identifier for routing)
+            // We use the first matching provider's agentId for all invocations
+            if (!targetAgentId && matchingProvider.agentId) {
+                targetAgentId = matchingProvider.agentId;
+                targetDisplayName = matchingProvider.displayName;
+            }
+            // Add tool to our list (convert to ToolDefinition format)
+            matchingTools.push({
+                name: tool.name,
+                description: tool.description ?? '',
+                inputSchema: tool.inputSchema ?? { type: 'object' },
+            });
+        }
+    }
+    // Step 3: Validate we found the ability
+    if (!targetAgentId || matchingTools.length === 0) {
+        // Build list of available agents for helpful error message
+        const availableAgents = new Set();
+        for (const tool of response.tools) {
+            for (const provider of tool.providers ?? []) {
+                if (provider.displayName) {
+                    availableAgents.add(provider.displayName);
+                }
+            }
+        }
+        throw new KadiError(`Ability "${abilityName}" not found on broker "${broker.name}"`, 'ABILITY_NOT_FOUND', {
+            abilityName,
+            broker: broker.name,
+            availableAgents: [...availableAgents],
+            hint: 'Make sure an agent with this name is connected to the broker',
+        });
+    }
+    return {
+        agentId: targetAgentId,
+        name: targetDisplayName ?? abilityName,
+        tools: matchingTools,
+    };
+}
+// ═══════════════════════════════════════════════════════════════════════════════
+// REMOTE INVOCATION
+// ═══════════════════════════════════════════════════════════════════════════════
+/**
+ * Invoke a tool on a remote agent via the broker.
+ *
+ * Uses the KADI async invocation pattern:
+ * 1. Send kadi.ability.request with toolName and toolInput
+ * 2. Broker returns { status: 'pending', requestId }
+ * 3. Wait for kadi.ability.response notification with the result
+ *
+ * For consistent routing to a specific agent, we inject _kadi routing hints
+ * into the toolInput. The broker strips these before forwarding to the provider.
+ *
+ * @param broker - The broker connection to use
+ * @param targetAgentId - Agent ID to route to (uses requireAgent hint)
+ * @param toolName - Name of the tool to invoke
+ * @param params - Parameters for the tool
+ * @param timeoutMs - Timeout in milliseconds
+ * @returns The tool's result
+ */
+async function invokeViaBroker(broker, targetAgentId, toolName, params, timeoutMs) {
+    // Fail fast if broker isn't properly initialized
+    if (!broker.pendingInvocations) {
+        throw new KadiError(`Broker "${broker.name}" is missing pendingInvocations map`, 'BROKER_ERROR', { broker: broker.name, hint: 'This is a bug in broker initialization' });
+    }
+    // Inject routing hint to ensure the broker routes to our target agent
+    // The _kadi property is stripped by the broker before forwarding to the provider
+    const paramsWithRouting = {
+        ...(typeof params === 'object' && params !== null ? params : {}),
+        _kadi: { requireAgent: targetAgentId },
+    };
+    // Use kadi.ability.request (the standard tool invocation method)
+    // The response is { status: 'pending', requestId }
+    // The actual result comes via kadi.ability.response notification,
+    // which is handled by the KadiClient's message handler
+    const pendingResult = (await sendBrokerRequest(broker, 'kadi.ability.request', {
+        toolName,
+        toolInput: paramsWithRouting,
+    }, timeoutMs));
+    if (pendingResult.status !== 'pending' || !pendingResult.requestId) {
+        throw new KadiError('Unexpected response from broker: expected pending acknowledgment', 'BROKER_ERROR', {
+            broker: broker.name,
+            toolName,
+            response: pendingResult,
+        });
+    }
+    // Store requestId locally - TypeScript now knows it's defined
+    const requestId = pendingResult.requestId;
+    // Wait for the actual result via kadi.ability.response
+    // This is handled by registering with the broker's pending invocations
+    return new Promise((resolve, reject) => {
+        const timeout = setTimeout(() => {
+            broker.pendingInvocations.delete(requestId);
+            reject(new KadiError(`Tool "${toolName}" invocation timed out`, 'BROKER_TIMEOUT', {
+                broker: broker.name,
+                toolName,
+                requestId,
+                timeout: timeoutMs,
+            }));
+        }, timeoutMs);
+        broker.pendingInvocations.set(requestId, {
+            resolve: (result) => {
+                clearTimeout(timeout);
+                resolve(result);
+            },
+            reject: (error) => {
+                clearTimeout(timeout);
+                reject(error);
+            },
+            timeout,
+            toolName,
+            sentAt: new Date(),
+        });
+    });
+}
+// ═══════════════════════════════════════════════════════════════════════════════
+// BROKER TRANSPORT
+// ═══════════════════════════════════════════════════════════════════════════════
+/**
+ * Load a remote ability via broker.
+ *
+ * This discovers an agent providing the ability and returns a LoadedAbility
+ * interface that invokes tools via the broker, consistently routing to that
+ * specific agent.
+ *
+ * @param abilityName - Name of the ability to load (matches agent's displayName)
+ * @param options - Broker connection and options
+ * @returns LoadedAbility that can invoke tools remotely
+ *
+ * @example
+ * ```typescript
+ * // The broker state comes from KadiClient
+ * const brokerState = client.getBrokerState('production');
+ *
+ * // Load a remote ability
+ * const analyzer = await loadBrokerTransport('text-analyzer', {
+ *   broker: brokerState,
+ *   requestTimeout: 60000,
+ * });
+ *
+ * // Invoke tools on the remote agent
+ * const result = await analyzer.invoke('analyze', { text: 'hello' });
+ *
+ * // All invocations go to the same agent (consistent routing)
+ * const result2 = await analyzer.invoke('summarize', { text: 'world' });
+ * ```
+ */
+export async function loadBrokerTransport(abilityName, options) {
+    const timeoutMs = options.requestTimeout ?? 30000;
+    // ─────────────────────────────────────────────────────────────────────────────
+    // Step 1: Discover the ability on the broker
+    // ─────────────────────────────────────────────────────────────────────────────
+    // TODO: Replace discoverAbilityWorkaround with kadi.agent.discover when
+    // the broker implements it. See: kadi-broker/docs/design/ABILITY_CENTRIC_DISCOVERY.md
+    const discovered = await discoverAbilityWorkaround(options.broker, abilityName, {
+        timeoutMs,
+    });
+    // ─────────────────────────────────────────────────────────────────────────────
+    // Step 2: Return LoadedAbility interface
+    // ─────────────────────────────────────────────────────────────────────────────
+    // The agentId is used for routing hints, ensuring all invocations go to the
+    // same agent. This is stable across reconnects (unlike sessionId).
+    return {
+        name: discovered.name,
+        transport: 'broker',
+        /**
+         * Invoke a tool on the remote agent.
+         *
+         * Routes through the broker to the target agent using _kadi.requireAgent
+         * routing hint. This ensures all calls go to the same agent that was
+         * discovered during loadBrokerTransport().
+         */
+        async invoke(toolName, params) {
+            try {
+                return await invokeViaBroker(options.broker, discovered.agentId, toolName, params, timeoutMs);
+            }
+            catch (error) {
+                // Re-throw KadiErrors as-is
+                if (error instanceof KadiError) {
+                    throw error;
+                }
+                // Wrap other errors
+                throw new KadiError(`Remote tool "${toolName}" invocation failed`, 'TOOL_INVOCATION_FAILED', {
+                    toolName,
+                    ability: discovered.name,
+                    targetAgent: discovered.agentId,
+                    broker: options.broker.name,
+                    reason: error instanceof Error ? error.message : String(error),
+                });
+            }
+        },
+        /**
+         * Get the list of tools this ability provides.
+         *
+         * Returns tools discovered from the agent during loadBrokerTransport().
+         * This is a snapshot from discovery time - if the agent registers new
+         * tools, you'd need to reload the ability to see them.
+         */
+        getTools() {
+            return discovered.tools;
+        },
+        /**
+         * Subscribe to events from this ability.
+         * NOT YET IMPLEMENTED for broker transport.
+         */
+        on(_event, _handler) {
+            throw new KadiError('Events are not yet implemented for broker transport', 'NOT_IMPLEMENTED', { transport: 'broker', hint: 'Use stdio or native transport for events' });
+        },
+        /**
+         * Unsubscribe from events.
+         * NOT YET IMPLEMENTED for broker transport.
+         */
+        off(_event, _handler) {
+            throw new KadiError('Events are not yet implemented for broker transport', 'NOT_IMPLEMENTED', { transport: 'broker', hint: 'Use stdio or native transport for events' });
+        },
+        /**
+         * Disconnect and cleanup.
+         *
+         * For broker transport, there's nothing to cleanup. The broker connection
+         * is managed by KadiClient, not by individual abilities. Calling disconnect()
+         * on a broker-loaded ability is a safe no-op.
+         */
+        async disconnect() {
+            // Broker connection is shared - we don't disconnect it here.
+            // The KadiClient manages broker lifecycle.
+        },
+    };
+}
+//# sourceMappingURL=broker.js.map

package/dist/transports/broker.js.map

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

package/dist/transports/native.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Native transport for kadi-core v0.1.0
+ *
+ * Loads abilities that run in the SAME Node.js process.
+ * This is the fastest transport - direct function calls with zero serialization.
+ *
+ * How it works:
+ * 1. Dynamic import the module at the given path
+ * 2. Verify it exports a KadiClient as default
+ * 3. Return a LoadedAbility that delegates to the client
+ *
+ * Use case: Abilities written in TypeScript/JavaScript that you want
+ * to load without spawning a child process.
+ */
+import type { LoadedAbility } from '../types.js';
+/**
+ * Load an in-process ability via dynamic import.
+ *
+ * The module at the given path must export a KadiClient instance as default.
+ * This is the standard pattern for KADI abilities.
+ *
+ * @param path - Absolute path to the ability module
+ * @returns LoadedAbility that can invoke tools
+ * @throws KadiError if the module can't be loaded or doesn't export a KadiClient
+ *
+ * @example
+ * ```typescript
+ * // The ability module (calculator/index.ts):
+ * const client = new KadiClient({ name: 'calculator' });
+ * client.registerTool(...);
+ * export default client;
+ *
+ * // Loading it:
+ * const calc = await loadNativeTransport('/path/to/calculator');
+ * const result = await calc.invoke('add', { a: 5, b: 3 });
+ * ```
+ */
+export declare function loadNativeTransport(path: string): Promise<LoadedAbility>;
+//# sourceMappingURL=native.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"native.d.ts","sourceRoot":"","sources":["../../src/transports/native.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAgC,MAAM,aAAa,CAAC;AAgE/E;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAwJ9E"}

package/dist/transports/native.js

@@ -0,0 +1,189 @@
+/**
+ * Native transport for kadi-core v0.1.0
+ *
+ * Loads abilities that run in the SAME Node.js process.
+ * This is the fastest transport - direct function calls with zero serialization.
+ *
+ * How it works:
+ * 1. Dynamic import the module at the given path
+ * 2. Verify it exports a KadiClient as default
+ * 3. Return a LoadedAbility that delegates to the client
+ *
+ * Use case: Abilities written in TypeScript/JavaScript that you want
+ * to load without spawning a child process.
+ */
+import { KadiError } from '../errors.js';
+/**
+ * Check if an object looks like a KadiClient.
+ * We check for the methods we need rather than using instanceof,
+ * because the loaded module might have a different version of KadiClient.
+ */
+function isKadiClient(obj) {
+    if (obj === null || typeof obj !== 'object') {
+        return false;
+    }
+    const candidate = obj;
+    // Must have readAgentJson method
+    if (typeof candidate.readAgentJson !== 'function') {
+        return false;
+    }
+    // Must have invoke method
+    if (typeof candidate.invoke !== 'function') {
+        return false;
+    }
+    // Must have setEventHandler method (for events)
+    if (typeof candidate.setEventHandler !== 'function') {
+        return false;
+    }
+    return true;
+}
+// ═══════════════════════════════════════════════════════════════════════════════
+// NATIVE TRANSPORT
+// ═══════════════════════════════════════════════════════════════════════════════
+/**
+ * Load an in-process ability via dynamic import.
+ *
+ * The module at the given path must export a KadiClient instance as default.
+ * This is the standard pattern for KADI abilities.
+ *
+ * @param path - Absolute path to the ability module
+ * @returns LoadedAbility that can invoke tools
+ * @throws KadiError if the module can't be loaded or doesn't export a KadiClient
+ *
+ * @example
+ * ```typescript
+ * // The ability module (calculator/index.ts):
+ * const client = new KadiClient({ name: 'calculator' });
+ * client.registerTool(...);
+ * export default client;
+ *
+ * // Loading it:
+ * const calc = await loadNativeTransport('/path/to/calculator');
+ * const result = await calc.invoke('add', { a: 5, b: 3 });
+ * ```
+ */
+export async function loadNativeTransport(path) {
+    // Step 1: Dynamic import the module
+    let module;
+    try {
+        module = await import(path);
+    }
+    catch (error) {
+        throw new KadiError(`Failed to import ability at "${path}"`, 'NATIVE_IMPORT_ERROR', {
+            path,
+            reason: error instanceof Error ? error.message : String(error),
+            hint: 'Check that the path is correct and the module has no syntax errors',
+        });
+    }
+    // Step 2: Get the default export
+    const client = module.default;
+    if (client === undefined) {
+        throw new KadiError(`Module at "${path}" has no default export`, 'ABILITY_LOAD_FAILED', {
+            path,
+            hint: 'The ability must export a KadiClient instance as default export',
+            alternative: 'Example: export default client;',
+        });
+    }
+    // Step 3: Verify it's a KadiClient
+    if (!isKadiClient(client)) {
+        throw new KadiError(`Module at "${path}" does not export a KadiClient`, 'ABILITY_LOAD_FAILED', {
+            path,
+            hint: 'The default export must be a KadiClient instance',
+            alternative: 'Make sure you\'re exporting the client, not the class',
+        });
+    }
+    // Step 4: Get agent information
+    let agentJson;
+    try {
+        agentJson = client.readAgentJson();
+    }
+    catch (error) {
+        throw new KadiError(`Failed to read agent information from "${path}"`, 'ABILITY_LOAD_FAILED', {
+            path,
+            reason: error instanceof Error ? error.message : String(error),
+            hint: 'The ability\'s readAgentJson() method threw an error',
+        });
+    }
+    // Step 5: Set up event handling
+    // Map of event name → array of handlers
+    const eventHandlers = new Map();
+    // When ability calls emit(), this callback fires
+    client.setEventHandler((event, data) => {
+        const handlers = eventHandlers.get(event);
+        if (handlers) {
+            for (const handler of handlers) {
+                // Fire handlers asynchronously, don't block
+                Promise.resolve(handler(data)).catch((err) => {
+                    console.error(`[KADI] Event handler error for "${event}":`, err);
+                });
+            }
+        }
+    });
+    // Step 6: Return LoadedAbility interface
+    return {
+        name: agentJson.name,
+        transport: 'native',
+        /**
+         * Invoke a tool on this ability.
+         * For native transport, this is a direct function call - no serialization.
+         */
+        async invoke(toolName, params) {
+            try {
+                const result = await client.invoke(toolName, params);
+                return result;
+            }
+            catch (error) {
+                // Re-throw KadiErrors as-is
+                if (error instanceof KadiError) {
+                    throw error;
+                }
+                // Wrap other errors
+                throw new KadiError(`Tool "${toolName}" invocation failed`, 'TOOL_INVOCATION_FAILED', {
+                    toolName,
+                    ability: agentJson.name,
+                    reason: error instanceof Error ? error.message : String(error),
+                });
+            }
+        },
+        /**
+         * Get the list of tools this ability provides.
+         */
+        getTools() {
+            return agentJson.tools ?? [];
+        },
+        /**
+         * Subscribe to events from this ability.
+         */
+        on(event, handler) {
+            let handlers = eventHandlers.get(event);
+            if (!handlers) {
+                handlers = new Set();
+                eventHandlers.set(event, handlers);
+            }
+            handlers.add(handler);
+        },
+        /**
+         * Unsubscribe from events.
+         */
+        off(event, handler) {
+            const handlers = eventHandlers.get(event);
+            if (handlers) {
+                handlers.delete(handler);
+                if (handlers.size === 0) {
+                    eventHandlers.delete(event);
+                }
+            }
+        },
+        /**
+         * Disconnect and cleanup.
+         * For native transport, there's nothing to cleanup - we share the process.
+         */
+        async disconnect() {
+            // Clear all event handlers
+            eventHandlers.clear();
+            // Native abilities share the process with us.
+            // No other cleanup needed.
+        },
+    };
+}
+//# sourceMappingURL=native.js.map

package/dist/transports/native.js.map

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