agents-library 1.1.0

package/dist/base-agent.d.ts

@@ -0,0 +1,172 @@
+/**
+ * BaseAgent - Shared Foundation for All KĀDI Agents
+ * ==================================================
+ *
+ * Provides the common infrastructure that all agents need:
+ * - KadiClient setup and broker connection (non-blocking connect())
+ * - Optional ProviderManager for LLM operations
+ * - Optional MemoryService for context persistence
+ * - Graceful shutdown handling (SIGINT/SIGTERM)
+ * - Agent metadata (agentId, agentRole)
+ *
+ * Design: Composition, not inheritance. Each agent repo instantiates BaseAgent
+ * and implements its own behavior. BaseAgent is a concrete class, not abstract.
+ *
+ * Usage:
+ * ```typescript
+ * const agent = new BaseAgent({
+ *   agentId: 'agent-artist',
+ *   agentRole: 'artist',
+ *   brokerUrl: 'ws://localhost:8080',
+ *   networks: ['global'],
+ * });
+ * await agent.connect();
+ * // ... agent-specific logic using agent.client, agent.providerManager, etc.
+ * ```
+ *
+ * @module base-agent
+ */
+import { KadiClient } from '@kadi.build/core';
+import { ProviderManager } from './providers/provider-manager.js';
+import { MemoryService } from './memory/memory-service.js';
+/**
+ * Provider configuration for BaseAgent.
+ * Controls which LLM providers are available and how they fail over.
+ */
+export interface BaseAgentProviderConfig {
+    /** Anthropic API key (required if using Anthropic provider) */
+    anthropicApiKey?: string;
+    /** Model Manager Gateway base URL (optional, enables model-manager provider) */
+    modelManagerBaseUrl?: string;
+    /** Model Manager Gateway API key (required if modelManagerBaseUrl is set) */
+    modelManagerApiKey?: string;
+    /**
+     * Primary provider name.
+     * @default 'anthropic' if only anthropicApiKey is set
+     * @default 'model-manager' if modelManagerBaseUrl is set
+     */
+    primaryProvider?: string;
+    /** Fallback provider name (optional, enables automatic failover) */
+    fallbackProvider?: string;
+    /** Number of retry attempts for failed LLM calls @default 3 */
+    retryAttempts?: number;
+    /** Delay between retries in milliseconds @default 1000 */
+    retryDelayMs?: number;
+    /** Health check interval in milliseconds @default 60000 */
+    healthCheckIntervalMs?: number;
+}
+/**
+ * Memory configuration for BaseAgent.
+ * Controls where conversation context and knowledge are stored.
+ */
+export interface BaseAgentMemoryConfig {
+    /** Path to file-based memory storage directory */
+    dataPath: string;
+    /** ArcadeDB URL for long-term memory (optional) */
+    arcadedbUrl?: string;
+    /** ArcadeDB root password @default 'root' */
+    arcadedbPassword?: string;
+}
+/**
+ * Configuration for BaseAgent.
+ * Only agentId, agentRole, brokerUrl, and networks are required.
+ * Provider and memory are optional — agents without them still work.
+ */
+export interface BaseAgentConfig {
+    /** Unique agent identifier (e.g., 'agent-producer', 'agent-artist') */
+    agentId: string;
+    /** Agent role (e.g., 'producer', 'artist', 'designer', 'programmer') */
+    agentRole: string;
+    /** Agent version string @default '1.0.0' */
+    version?: string;
+    /** KĀDI broker WebSocket URL (used as the 'default' broker) */
+    brokerUrl: string;
+    /** KĀDI networks this agent belongs to (for the default broker) */
+    networks: string[];
+    /**
+     * Additional named brokers to connect to simultaneously.
+     * Each key is a broker name, value is { url, networks }.
+     * The primary broker (brokerUrl + networks) is always named 'default'.
+     *
+     * @example
+     * ```typescript
+     * additionalBrokers: {
+     *   remote: { url: 'ws://remote:8080/kadi', networks: ['global'] },
+     * }
+     * ```
+     */
+    additionalBrokers?: Record<string, {
+        url: string;
+        networks: string[];
+    }>;
+    /** Optional LLM provider configuration */
+    provider?: BaseAgentProviderConfig;
+    /** Optional memory service configuration */
+    memory?: BaseAgentMemoryConfig;
+}
+/**
+ * Shared foundation for all KĀDI agents.
+ *
+ * Provides KadiClient, optional ProviderManager, optional MemoryService,
+ * and graceful shutdown. Each agent repo uses BaseAgent via composition
+ * and adds its own behavior.
+ */
+export declare class BaseAgent {
+    /** KĀDI protocol client for broker communication */
+    readonly client: KadiClient;
+    /** LLM provider manager (undefined if no provider config) */
+    readonly providerManager?: ProviderManager;
+    /** Memory service for context persistence (undefined if no memory config) */
+    readonly memoryService?: MemoryService;
+    /** Agent configuration */
+    readonly config: BaseAgentConfig;
+    /** Whether shutdown handlers have been registered */
+    private shutdownHandlersRegistered;
+    /** Whether the agent is currently connected */
+    private connected;
+    /** Timer key for this agent's lifetime tracking */
+    private readonly timerKey;
+    constructor(config: BaseAgentConfig);
+    /**
+     * Connect to KĀDI broker and initialize async services.
+     *
+     * Uses client.connect() (non-blocking) — NOT client.serve() which blocks forever.
+     * After connection, initializes MemoryService if configured.
+     */
+    connect(): Promise<void>;
+    /**
+     * Register SIGINT/SIGTERM handlers for graceful shutdown.
+     *
+     * Call this once after setting up agent-specific resources.
+     * The shutdown sequence: agent-specific cleanup → disconnect → exit.
+     *
+     * @param onBeforeShutdown - Optional async callback for agent-specific cleanup
+     *   (e.g., stopping bots, unsubscribing events) before broker disconnect.
+     */
+    registerShutdownHandlers(onBeforeShutdown?: () => Promise<void>): void;
+    /**
+     * Shut down the agent: dispose services and disconnect from broker.
+     *
+     * Can be called directly for programmatic shutdown, or automatically
+     * via registered signal handlers.
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Check if the agent is currently connected to the broker.
+     */
+    isConnected(): boolean;
+    /**
+     * Get agent metadata for inclusion in event payloads.
+     * Used by the generic event naming system (task 3.11).
+     */
+    getMetadata(): {
+        agentId: string;
+        agentRole: string;
+    };
+    /**
+     * Create ProviderManager from provider configuration.
+     * Instantiates the appropriate LLM providers based on available credentials.
+     */
+    private createProviderManager;
+}
+//# sourceMappingURL=base-agent.d.ts.map

package/dist/base-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-agent.d.ts","sourceRoot":"","sources":["../src/base-agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAGlE,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAS3D;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,+DAA+D;IAC/D,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,gFAAgF;IAChF,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAE7B,6EAA6E;IAC7E,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,oEAAoE;IACpE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,+DAA+D;IAC/D,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,2DAA2D;IAC3D,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,kDAAkD;IAClD,QAAQ,EAAE,MAAM,CAAC;IAEjB,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,6CAA6C;IAC7C,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,uEAAuE;IACvE,OAAO,EAAE,MAAM,CAAC;IAEhB,wEAAwE;IACxE,SAAS,EAAE,MAAM,CAAC;IAElB,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,+DAA+D;IAC/D,SAAS,EAAE,MAAM,CAAC;IAElB,mEAAmE;IACnE,QAAQ,EAAE,MAAM,EAAE,CAAC;IAEnB;;;;;;;;;;;OAWG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IAExE,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,uBAAuB,CAAC;IAEnC,4CAA4C;IAC5C,MAAM,CAAC,EAAE,qBAAqB,CAAC;CAChC;AAMD;;;;;;GAMG;AACH,qBAAa,SAAS;IACpB,oDAAoD;IACpD,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAE5B,6DAA6D;IAC7D,QAAQ,CAAC,eAAe,CAAC,EAAE,eAAe,CAAC;IAE3C,6EAA6E;IAC7E,QAAQ,CAAC,aAAa,CAAC,EAAE,aAAa,CAAC;IAEvC,0BAA0B;IAC1B,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IAEjC,qDAAqD;IACrD,OAAO,CAAC,0BAA0B,CAAS;IAE3C,+CAA+C;IAC/C,OAAO,CAAC,SAAS,CAAS;IAE1B,mDAAmD;IACnD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEtB,MAAM,EAAE,eAAe;IA8CnC;;;;;OAKG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA0B9B;;;;;;;;OAQG;IACH,wBAAwB,CAAC,gBAAgB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAiCtE;;;;;OAKG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAmC/B;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;;OAGG;IACH,WAAW,IAAI;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE;IAWrD;;;OAGG;IACH,OAAO,CAAC,qBAAqB;CAuC9B"}

package/dist/base-agent.js

@@ -0,0 +1,255 @@
+/**
+ * BaseAgent - Shared Foundation for All KĀDI Agents
+ * ==================================================
+ *
+ * Provides the common infrastructure that all agents need:
+ * - KadiClient setup and broker connection (non-blocking connect())
+ * - Optional ProviderManager for LLM operations
+ * - Optional MemoryService for context persistence
+ * - Graceful shutdown handling (SIGINT/SIGTERM)
+ * - Agent metadata (agentId, agentRole)
+ *
+ * Design: Composition, not inheritance. Each agent repo instantiates BaseAgent
+ * and implements its own behavior. BaseAgent is a concrete class, not abstract.
+ *
+ * Usage:
+ * ```typescript
+ * const agent = new BaseAgent({
+ *   agentId: 'agent-artist',
+ *   agentRole: 'artist',
+ *   brokerUrl: 'ws://localhost:8080',
+ *   networks: ['global'],
+ * });
+ * await agent.connect();
+ * // ... agent-specific logic using agent.client, agent.providerManager, etc.
+ * ```
+ *
+ * @module base-agent
+ */
+import { KadiClient } from '@kadi.build/core';
+import { ProviderManager } from './providers/provider-manager.js';
+import { AnthropicProvider } from './providers/anthropic-provider.js';
+import { ModelManagerProvider } from './providers/model-manager-provider.js';
+import { MemoryService } from './memory/memory-service.js';
+import { logger, MODULE_AGENT } from './utils/logger.js';
+import { timer } from './utils/timer.js';
+// ============================================================================
+// BaseAgent Class
+// ============================================================================
+/**
+ * Shared foundation for all KĀDI agents.
+ *
+ * Provides KadiClient, optional ProviderManager, optional MemoryService,
+ * and graceful shutdown. Each agent repo uses BaseAgent via composition
+ * and adds its own behavior.
+ */
+export class BaseAgent {
+    /** KĀDI protocol client for broker communication */
+    client;
+    /** LLM provider manager (undefined if no provider config) */
+    providerManager;
+    /** Memory service for context persistence (undefined if no memory config) */
+    memoryService;
+    /** Agent configuration */
+    config;
+    /** Whether shutdown handlers have been registered */
+    shutdownHandlersRegistered = false;
+    /** Whether the agent is currently connected */
+    connected = false;
+    /** Timer key for this agent's lifetime tracking */
+    timerKey;
+    constructor(config) {
+        this.config = config;
+        this.timerKey = `base-agent-${config.agentId}`;
+        timer.start(this.timerKey);
+        logger.info(MODULE_AGENT, `Initializing BaseAgent: ${config.agentId} (role: ${config.agentRole})`, timer.elapsed(this.timerKey));
+        // Build brokers map: 'default' + any additional brokers
+        const brokers = {
+            default: { url: config.brokerUrl, networks: config.networks },
+        };
+        if (config.additionalBrokers) {
+            for (const [name, entry] of Object.entries(config.additionalBrokers)) {
+                brokers[name] = { url: entry.url, networks: entry.networks };
+                logger.info(MODULE_AGENT, `   Broker '${name}': ${entry.url} [${entry.networks.join(', ')}]`, timer.elapsed(this.timerKey));
+            }
+        }
+        // Create KadiClient
+        this.client = new KadiClient({
+            name: config.agentId,
+            version: config.version || '1.0.0',
+            brokers,
+            defaultBroker: 'default',
+        });
+        // Create ProviderManager if configured
+        if (config.provider) {
+            this.providerManager = this.createProviderManager(config.provider);
+            logger.info(MODULE_AGENT, '   ✅ ProviderManager created', timer.elapsed(this.timerKey));
+        }
+        // Create MemoryService if configured (requires async initialize() later)
+        if (config.memory) {
+            this.memoryService = new MemoryService(config.memory.dataPath, config.memory.arcadedbUrl, config.memory.arcadedbPassword, this.providerManager);
+            logger.info(MODULE_AGENT, '   ✅ MemoryService created (pending initialization)', timer.elapsed(this.timerKey));
+        }
+        logger.info(MODULE_AGENT, `   BaseAgent initialized for ${config.agentId}`, timer.elapsed(this.timerKey));
+    }
+    /**
+     * Connect to KĀDI broker and initialize async services.
+     *
+     * Uses client.connect() (non-blocking) — NOT client.serve() which blocks forever.
+     * After connection, initializes MemoryService if configured.
+     */
+    async connect() {
+        const brokerCount = 1 + Object.keys(this.config.additionalBrokers || {}).length;
+        logger.info(MODULE_AGENT, `Connecting ${this.config.agentId} to ${brokerCount} broker(s)...`, timer.elapsed(this.timerKey));
+        logger.info(MODULE_AGENT, `   Broker 'default': ${this.config.brokerUrl} [${this.config.networks.join(', ')}]`, timer.elapsed(this.timerKey));
+        try {
+            await this.client.connect();
+            this.connected = true;
+            logger.info(MODULE_AGENT, `   ✅ Connected to ${brokerCount} broker(s)`, timer.elapsed(this.timerKey));
+        }
+        catch (error) {
+            logger.error(MODULE_AGENT, `Failed to connect to broker: ${error.message || String(error)}`, timer.elapsed(this.timerKey), error);
+            throw error;
+        }
+        // Initialize MemoryService after connection (async operation)
+        if (this.memoryService) {
+            try {
+                await this.memoryService.initialize();
+                logger.info(MODULE_AGENT, '   ✅ MemoryService initialized', timer.elapsed(this.timerKey));
+            }
+            catch (error) {
+                // Memory initialization failure is non-fatal — agent can still operate
+                logger.error(MODULE_AGENT, `MemoryService initialization failed (non-fatal): ${error.message || String(error)}`, timer.elapsed(this.timerKey), error);
+            }
+        }
+    }
+    /**
+     * Register SIGINT/SIGTERM handlers for graceful shutdown.
+     *
+     * Call this once after setting up agent-specific resources.
+     * The shutdown sequence: agent-specific cleanup → disconnect → exit.
+     *
+     * @param onBeforeShutdown - Optional async callback for agent-specific cleanup
+     *   (e.g., stopping bots, unsubscribing events) before broker disconnect.
+     */
+    registerShutdownHandlers(onBeforeShutdown) {
+        if (this.shutdownHandlersRegistered) {
+            logger.info(MODULE_AGENT, 'Shutdown handlers already registered, skipping', timer.elapsed(this.timerKey));
+            return;
+        }
+        const shutdownHandler = async (signal) => {
+            logger.info(MODULE_AGENT, `${signal} received, shutting down ${this.config.agentId}...`, timer.elapsed(this.timerKey));
+            try {
+                // Step 1: Agent-specific cleanup
+                if (onBeforeShutdown) {
+                    await onBeforeShutdown();
+                }
+                // Step 2: Shutdown base services
+                await this.shutdown();
+                logger.info(MODULE_AGENT, 'Graceful shutdown complete', timer.elapsed(this.timerKey));
+                process.exit(0);
+            }
+            catch (error) {
+                logger.error(MODULE_AGENT, `Error during shutdown: ${error.message || String(error)}`, timer.elapsed(this.timerKey), error);
+                process.exit(1);
+            }
+        };
+        process.on('SIGTERM', () => shutdownHandler('SIGTERM'));
+        process.on('SIGINT', () => shutdownHandler('SIGINT'));
+        this.shutdownHandlersRegistered = true;
+        logger.info(MODULE_AGENT, 'Shutdown handlers registered (SIGTERM, SIGINT)', timer.elapsed(this.timerKey));
+    }
+    /**
+     * Shut down the agent: dispose services and disconnect from broker.
+     *
+     * Can be called directly for programmatic shutdown, or automatically
+     * via registered signal handlers.
+     */
+    async shutdown() {
+        logger.info(MODULE_AGENT, `Shutting down ${this.config.agentId}...`, timer.elapsed(this.timerKey));
+        // Dispose ProviderManager (stops health checks)
+        if (this.providerManager) {
+            try {
+                this.providerManager.dispose();
+                logger.info(MODULE_AGENT, '   ProviderManager disposed', timer.elapsed(this.timerKey));
+            }
+            catch (error) {
+                logger.error(MODULE_AGENT, `Error disposing ProviderManager: ${error.message}`, timer.elapsed(this.timerKey));
+            }
+        }
+        // Dispose MemoryService
+        if (this.memoryService) {
+            try {
+                this.memoryService.dispose();
+                logger.info(MODULE_AGENT, '   MemoryService disposed', timer.elapsed(this.timerKey));
+            }
+            catch (error) {
+                logger.error(MODULE_AGENT, `Error disposing MemoryService: ${error.message}`, timer.elapsed(this.timerKey));
+            }
+        }
+        // Disconnect from broker (clears subscriptions, unloads abilities)
+        if (this.connected) {
+            try {
+                await this.client.disconnect();
+                this.connected = false;
+                logger.info(MODULE_AGENT, '   Disconnected from broker', timer.elapsed(this.timerKey));
+            }
+            catch (error) {
+                logger.error(MODULE_AGENT, `Error disconnecting from broker: ${error.message}`, timer.elapsed(this.timerKey));
+            }
+        }
+    }
+    /**
+     * Check if the agent is currently connected to the broker.
+     */
+    isConnected() {
+        return this.connected;
+    }
+    /**
+     * Get agent metadata for inclusion in event payloads.
+     * Used by the generic event naming system (task 3.11).
+     */
+    getMetadata() {
+        return {
+            agentId: this.config.agentId,
+            agentRole: this.config.agentRole,
+        };
+    }
+    // ============================================================================
+    // Private Helpers
+    // ============================================================================
+    /**
+     * Create ProviderManager from provider configuration.
+     * Instantiates the appropriate LLM providers based on available credentials.
+     */
+    createProviderManager(providerConfig) {
+        const providers = [];
+        // Add Anthropic provider if API key is available
+        if (providerConfig.anthropicApiKey) {
+            providers.push(new AnthropicProvider(providerConfig.anthropicApiKey));
+        }
+        // Add Model Manager provider if configured
+        if (providerConfig.modelManagerBaseUrl && providerConfig.modelManagerApiKey) {
+            providers.push(new ModelManagerProvider(providerConfig.modelManagerBaseUrl, providerConfig.modelManagerApiKey));
+        }
+        if (providers.length === 0) {
+            throw new Error('BaseAgent provider config requires at least one provider (set anthropicApiKey or modelManagerBaseUrl + modelManagerApiKey)');
+        }
+        // Determine primary/fallback providers
+        const hasBothProviders = providers.length > 1;
+        const primaryProvider = providerConfig.primaryProvider
+            || (providerConfig.modelManagerBaseUrl ? 'model-manager' : 'anthropic');
+        const fallbackProvider = providerConfig.fallbackProvider
+            || (hasBothProviders ? (primaryProvider === 'model-manager' ? 'anthropic' : 'model-manager') : undefined);
+        const config = {
+            primaryProvider,
+            fallbackProvider,
+            retryAttempts: providerConfig.retryAttempts ?? 3,
+            retryDelayMs: providerConfig.retryDelayMs ?? 1000,
+            healthCheckIntervalMs: providerConfig.healthCheckIntervalMs ?? 60000,
+        };
+        logger.info(MODULE_AGENT, `   Creating ProviderManager: primary=${primaryProvider}, fallback=${fallbackProvider || 'none'}, providers=${providers.length}`, timer.elapsed(this.timerKey));
+        return new ProviderManager(providers, config);
+    }
+}
+//# sourceMappingURL=base-agent.js.map

package/dist/base-agent.js.map

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