@hailer/mcp 0.1.17 → 0.2.1

package/REFACTOR_STATUS.md

@@ -1,127 +0,0 @@
-# Client Refactor Status
-
-## Completed
-
-### Services Created (src/client/services/)
-1. **message-formatter.ts** - Tag formatting, mention resolution, activity linking
-2. **mcp-client.ts** - MCP server communication, tool schema loading
-3. **session-logger.ts** - Activity session tracking, idle detection, session flushing
-4. **agent-registry.ts** - Agent Directory, Positions, Teams, Tool Registry, MCP Config
-
-### Files Moved (src/client/agents/)
-1. **definitions.ts** (was specialists.ts) - Specialist definitions
-2. **orchestrator.ts** (was orchestrator-daemon.ts) - Updated imports ✓
-3. **specialist.ts** (was specialist-daemon.ts) - Updated imports ✓
-
-### Files Renamed (src/client/)
-1. **factory.ts** (was daemon-factory.ts) - Needs import updates
-2. **bot-manager.ts** (was multi-bot-manager.ts) - Needs import updates
-
-### Types Extracted
-- **types.ts** - Already complete with all interfaces and constants
-
-## Remaining Work
-
-### 1. Create agents/base.ts
-Extract from chat-agent-daemon.ts (2109 lines):
-- Core LLM loop (~500 lines target)
-- Message queue management
-- Abstract getSystemPrompt()
-- Inject services via constructor:
-  - MessageFormatterService
-  - McpClientService
-  - SessionLoggerService
-  - AgentRegistryService
-
-### 2. Update factory.ts imports
-```typescript
-// Change:
-import { ChatAgentDaemon } from "./chat-agent-daemon";
-import { OrchestratorDaemon } from "./orchestrator-daemon";
-import { SpecialistDaemon } from "./specialist-daemon";
-import { SPECIALISTS } from "./specialists";
-import { MultiBotManager, BotClient } from "./multi-bot-manager";
-
-// To:
-import { ChatAgentDaemon } from "./agents/base";
-import { OrchestratorDaemon } from "./agents/orchestrator";
-import { SpecialistDaemon } from "./agents/specialist";
-import { SPECIALISTS } from "./agents/definitions";
-import { MultiBotManager, BotClient } from "./bot-manager";
-```
-
-### 3. Create index.ts (public exports)
-```typescript
-export * from "./types";
-export * from "./bot-manager";
-export * from "./factory";
-export * from "./agents/base";
-export * from "./agents/orchestrator";
-export * from "./agents/specialist";
-export * from "./agents/definitions";
-export * from "./services/message-formatter";
-export * from "./services/mcp-client";
-export * from "./services/session-logger";
-export * from "./services/agent-registry";
-```
-
-### 4. Update all imports in codebase
-Files that import from src/client/:
-- src/core.ts
-- src/config.ts
-- Any test files
-
-### 5. Delete old files
-After verifying build:
-- src/client/chat-agent-daemon.ts (replaced by agents/base.ts)
-
-### 6. Verify build
-```bash
-npm run build
-```
-
-## Architecture
-
-### Before
-```
-src/client/
-├── chat-agent-daemon.ts (2109 lines - BLOATED)
-├── orchestrator-daemon.ts
-├── specialist-daemon.ts
-├── specialists.ts
-├── daemon-factory.ts
-├── multi-bot-manager.ts
-└── types.ts
-```
-
-### After
-```
-src/client/
-├── index.ts                     # Public exports
-├── factory.ts                   # DaemonManager
-├── bot-manager.ts               # MultiBotManager
-├── types.ts                     # All interfaces
-│
-├── agents/
-│   ├── base.ts                  # Core LLM loop (~500 lines)
-│   ├── orchestrator.ts          # HAL orchestrator ✓
-│   ├── specialist.ts            # Domain experts ✓
-│   └── definitions.ts           # SPECIALISTS config ✓
-│
-└── services/
-    ├── message-formatter.ts     # Tags, mentions, links ✓
-    ├── mcp-client.ts            # Tool calling ✓
-    ├── session-logger.ts        # Session logging ✓
-    └── agent-registry.ts        # Agent Directory registration ✓
-```
-
-## Next Steps
-
-1. Create agents/base.ts with service injection
-2. Update factory.ts imports
-3. Update bot-manager.ts imports (if any internal references)
-4. Create index.ts
-5. Update imports in src/core.ts and other files
-6. Run npm run build
-7. Delete chat-agent-daemon.ts
-8. Test the refactored code

package/dist/agents/bot-manager.d.ts

@@ -1,48 +0,0 @@
-/**
- * Multi-Bot Client Manager
- * Manages multiple bot clients, each with their own Hailer connection
- */
-import { HailerClient } from "../mcp/hailer-clients";
-import { SignalHandler } from "../mcp/signal-handler";
-import { BotClientConfig } from "./shared/types";
-import { WorkspaceCache } from "../mcp/workspace-cache";
-export interface BotClient {
-    userId: string;
-    firstName: string;
-    lastName: string;
-    config: BotClientConfig;
-    client: HailerClient;
-    signalHandler: SignalHandler;
-    workspaceCache?: WorkspaceCache;
-}
-export declare class MultiBotManager {
-    private botConfigs;
-    private botClients;
-    constructor(botConfigs: BotClientConfig[]);
-    initializeAllHailerClientsFromConfig(): Promise<void>;
-    getBotClient(userId: string): BotClient | undefined;
-    getAllBotClients(): BotClient[];
-    getBotIds(): string[];
-    private userNameCache;
-    private static USER_CACHE_TTL;
-    /**
-     * Look up a user's full name by their user ID
-     * Uses workspace cache first, then falls back to socket API call
-     */
-    getUserName(userId: string): string | undefined;
-    /**
-     * Initialize a single bot client from credentials
-     * Used for dynamic bot creation from AI Hub
-     */
-    initializeBotClient(email: string, password: string, apiKey: string): Promise<string>;
-    /**
-     * Remove and disconnect a bot client
-     */
-    removeBotClient(userId: string): Promise<void>;
-    /**
-     * Get bot client by bot ID (hal, giuseppe, hailerExpert, vastuullisuus)
-     */
-    getBotClientByBotId(botId: string): BotClient | undefined;
-    shutdown(): Promise<void>;
-}
-//# sourceMappingURL=bot-manager.d.ts.map

package/dist/agents/bot-manager.js

@@ -1,254 +0,0 @@
-"use strict";
-/**
- * Multi-Bot Client Manager
- * Manages multiple bot clients, each with their own Hailer connection
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.MultiBotManager = void 0;
-const hailer_clients_1 = require("../mcp/hailer-clients");
-const signal_handler_1 = require("../mcp/signal-handler");
-const workspace_cache_1 = require("../mcp/workspace-cache");
-const config_1 = require("../config");
-const bot_config_1 = require("../mcp/tools/bot-config");
-const logger_1 = require("../lib/logger");
-const logger = (0, logger_1.createLogger)({ component: 'bot-manager' });
-class MultiBotManager {
-    botConfigs;
-    botClients = new Map();
-    constructor(botConfigs) {
-        this.botConfigs = botConfigs;
-    }
-    // for client we may put initializeAllConfigClients method to do it at once
-    // in case we only use MCP Server:
-    // for MCP Server it may just get a specific client and this class initialize it specifically and even kill it later if not needed
-    async initializeAllHailerClientsFromConfig() {
-        logger.info('Initializing bot clients', { count: this.botConfigs.length });
-        const appConfig = (0, config_1.createApplicationConfig)();
-        for (const config of this.botConfigs) {
-            try {
-                // Use shared connection pool via API key lookup
-                const client = await (0, hailer_clients_1.createHailerClientByApiKey)(config.mcpServerApiKey);
-                // Get user ID automatically from authenticated session
-                const userId = await (0, hailer_clients_1.getCurrentUserId)(client);
-                // Fetch init data to get workspace cache with user names and teams
-                let workspaceCache;
-                try {
-                    const init = await client.socket.request('v2.core.init', [['users', 'network', 'networks', 'teams']]);
-                    workspaceCache = (0, workspace_cache_1.createWorkspaceCache)(init, appConfig.mcpConfig);
-                    const teamCount = Object.keys(init.teams || {}).length;
-                    logger.info('Loaded workspace cache', { userCount: workspaceCache.users.length, teamCount });
-                }
-                catch (initError) {
-                    logger.warn('Could not load workspace cache', { email: (0, config_1.maskEmail)(config.email), error: String(initError) });
-                }
-                const signalHandler = signal_handler_1.SignalHandler.getOrCreate(client, workspaceCache);
-                // Look up user's name from workspace cache
-                let firstName = 'Bot';
-                let lastName = '';
-                if (workspaceCache) {
-                    const userInfo = workspaceCache.usersById[userId];
-                    if (userInfo) {
-                        firstName = userInfo.firstname || 'Bot';
-                        lastName = userInfo.lastname || '';
-                    }
-                }
-                // Check if we have a display name from Agent Directory and update Hailer profile
-                const localCreds = (0, bot_config_1.getLocalBotCredentials)(userId);
-                if (localCreds?.displayName) {
-                    const currentFullName = `${firstName} ${lastName}`.trim();
-                    if (currentFullName !== localCreds.displayName) {
-                        try {
-                            // Parse display name into first/last
-                            const parts = localCreds.displayName.trim().split(/\s+/);
-                            const newFirstName = parts[0] || localCreds.displayName;
-                            const newLastName = parts.slice(1).join(' ') || '';
-                            // Update Hailer profile via API
-                            await client.socket.request('user.set_user_info', ['firstname', [newFirstName]]);
-                            if (newLastName) {
-                                await client.socket.request('user.set_user_info', ['lastname', [newLastName]]);
-                            }
-                            firstName = newFirstName;
-                            lastName = newLastName;
-                            logger.info('Updated bot display name', { from: currentFullName, to: localCreds.displayName });
-                        }
-                        catch (nameError) {
-                            logger.warn('Could not update bot display name', { error: String(nameError) });
-                        }
-                    }
-                }
-                const botClient = {
-                    userId,
-                    firstName,
-                    lastName,
-                    config,
-                    client,
-                    signalHandler,
-                    workspaceCache,
-                };
-                this.botClients.set(userId, botClient);
-                logger.info('Bot client initialized', {
-                    email: (0, config_1.maskEmail)(config.email),
-                    userId,
-                    apiKey: (0, config_1.maskSensitiveData)(config.mcpServerApiKey),
-                });
-            }
-            catch (error) {
-                logger.error('Failed to initialize bot client', error, {
-                    email: (0, config_1.maskEmail)(config.email),
-                });
-                // Continue with other bots even if one fails
-            }
-        }
-        logger.info('Bot clients initialization complete', { count: this.botClients.size });
-    }
-    getBotClient(userId) {
-        const botClient = this.botClients.get(userId);
-        if (!botClient) {
-            logger.warn('No bot client found', { userId });
-        }
-        return botClient;
-    }
-    getAllBotClients() {
-        return Array.from(this.botClients.values());
-    }
-    getBotIds() {
-        return Array.from(this.botClients.keys());
-    }
-    // Simple in-memory cache for user lookups (refreshed on demand)
-    userNameCache = new Map();
-    static USER_CACHE_TTL = 5 * 60 * 1000; // 5 minutes
-    /**
-     * Look up a user's full name by their user ID
-     * Uses workspace cache first, then falls back to socket API call
-     */
-    getUserName(userId) {
-        // Check in-memory cache first (for API-fetched users)
-        const cached = this.userNameCache.get(userId);
-        if (cached && Date.now() - cached.fetchedAt < MultiBotManager.USER_CACHE_TTL) {
-            return cached.name;
-        }
-        // Try each bot client's workspace cache until we find the user
-        for (const botClient of this.botClients.values()) {
-            if (botClient.workspaceCache) {
-                const user = (0, workspace_cache_1.getUserById)(botClient.workspaceCache, userId);
-                if (user) {
-                    const fullName = `${user.firstname || ''} ${user.lastname || ''}`.trim();
-                    return fullName || user.fullName || undefined;
-                }
-            }
-        }
-        return undefined;
-    }
-    /**
-     * Initialize a single bot client from credentials
-     * Used for dynamic bot creation from AI Hub
-     */
-    async initializeBotClient(email, password, apiKey) {
-        const appConfig = (0, config_1.createApplicationConfig)();
-        // Check if bot with this email already exists
-        const existingBot = Array.from(this.botClients.values())
-            .find(bc => bc.config.email === email);
-        if (existingBot) {
-            logger.info('Bot client already exists', { email: (0, config_1.maskEmail)(email) });
-            return existingBot.userId;
-        }
-        const config = {
-            email,
-            password,
-            apiBaseUrl: 'https://api.hailer.com',
-            mcpServerApiKey: apiKey,
-        };
-        try {
-            const client = await (0, hailer_clients_1.createHailerClientByApiKey)(apiKey);
-            const userId = await (0, hailer_clients_1.getCurrentUserId)(client);
-            let workspaceCache;
-            let workspaceId;
-            try {
-                const init = await client.socket.request('v2.core.init', [['users', 'network', 'networks', 'teams']]);
-                workspaceCache = (0, workspace_cache_1.createWorkspaceCache)(init, appConfig.mcpConfig);
-                workspaceId = init?.network?._id;
-            }
-            catch (initError) {
-                logger.warn('Could not load workspace cache', { email: (0, config_1.maskEmail)(email), error: String(initError) });
-            }
-            const signalHandler = signal_handler_1.SignalHandler.getOrCreate(client, workspaceCache);
-            // Initialize workspace schema for this bot's workspace (discover Agent Directory)
-            if (workspaceId) {
-                try {
-                    const hailerApiClient = { getClient: () => client, fetchInit: (modules) => client.socket.request('v2.core.init', [modules]), listWorkflows: async () => {
-                            const init = await client.socket.request('v2.core.init', [['processes']]);
-                            return Object.values(init?.processes || {});
-                        } };
-                    await (0, bot_config_1.initWorkspaceSchema)(hailerApiClient, workspaceId);
-                    logger.info('Workspace schema initialized', { email: (0, config_1.maskEmail)(email), workspaceId });
-                }
-                catch (schemaError) {
-                    logger.warn('Could not initialize workspace schema', { email: (0, config_1.maskEmail)(email), error: String(schemaError) });
-                }
-            }
-            let firstName = 'Bot';
-            let lastName = '';
-            if (workspaceCache) {
-                const userInfo = workspaceCache.usersById[userId];
-                if (userInfo) {
-                    firstName = userInfo.firstname || 'Bot';
-                    lastName = userInfo.lastname || '';
-                }
-            }
-            const botClient = {
-                userId,
-                firstName,
-                lastName,
-                config,
-                client,
-                signalHandler,
-                workspaceCache,
-            };
-            this.botClients.set(userId, botClient);
-            logger.info('Bot client initialized', { email: (0, config_1.maskEmail)(email), userId });
-            return userId;
-        }
-        catch (error) {
-            logger.error('Failed to initialize bot client', error, { email: (0, config_1.maskEmail)(email) });
-            throw error;
-        }
-    }
-    /**
-     * Remove and disconnect a bot client
-     */
-    async removeBotClient(userId) {
-        const botClient = this.botClients.get(userId);
-        if (!botClient) {
-            logger.warn('Bot client not found for removal', { userId });
-            return;
-        }
-        (0, hailer_clients_1.disconnectHailerClientByApiKey)(botClient.config.mcpServerApiKey);
-        this.botClients.delete(userId);
-        logger.info('Bot client removed', { userId });
-    }
-    /**
-     * Get bot client by bot ID (hal, giuseppe, hailerExpert, vastuullisuus)
-     */
-    getBotClientByBotId(botId) {
-        // Match by email containing the bot ID
-        return Array.from(this.botClients.values())
-            .find(bc => bc.config.email.toLowerCase().includes(botId.toLowerCase()));
-    }
-    async shutdown() {
-        logger.info('Shutting down all bot clients', { count: this.botClients.size });
-        for (const [userId, botClient] of this.botClients) {
-            try {
-                // Properly disconnect from shared connection pool
-                (0, hailer_clients_1.disconnectHailerClientByApiKey)(botClient.config.mcpServerApiKey);
-                logger.info('Bot client shut down', { userId, apiKey: (0, config_1.maskSensitiveData)(botClient.config.mcpServerApiKey) });
-            }
-            catch (error) {
-                logger.error('Error shutting down bot client', error, { userId });
-            }
-        }
-        this.botClients.clear();
-        logger.info('All bot clients shut down');
-    }
-}
-exports.MultiBotManager = MultiBotManager;
-//# sourceMappingURL=bot-manager.js.map

package/dist/agents/factory.d.ts

@@ -1,150 +0,0 @@
-/**
- * Daemon Factory
- *
- * Creates and manages agent daemons in orchestrator mode:
- * - One orchestrator (HAL) handles general conversation
- * - Specialist daemons handle complex domain-specific tasks
- */
-import { ChatAgentDaemon } from "./shared/base";
-import { OrchestratorDaemon } from "./hal/daemon";
-import { SpecialistDaemon } from "./shared/specialist";
-import { MultiBotManager } from "./bot-manager";
-import { ConversationState } from "./shared/types";
-export interface DaemonManagerOptions {
-    mcpServerUrl: string;
-    anthropicApiKey: string;
-    model?: string;
-    /**
-     * Enable orchestrator mode (default: true)
-     * Set to false only for legacy compatibility
-     */
-    orchestratorMode?: boolean;
-    /**
-     * Email of the bot to use as orchestrator (defaults to first bot)
-     */
-    orchestratorEmail?: string;
-    /**
-     * Map of specialist key to bot email (e.g., { hailerExpert: "expert@bot.com" })
-     */
-    specialistEmails?: Record<string, string>;
-    /**
-     * Map of userId to botType (from workspace config)
-     */
-    botTypeMap?: Map<string, string>;
-    /**
-     * Map of userId to displayName (from Agent Directory activity name)
-     */
-    displayNameMap?: Map<string, string>;
-    /**
-     * Specific workspace ID to use (for webhook-triggered restarts)
-     */
-    workspaceId?: string;
-}
-/**
- * Manages orchestrator + specialist daemons
- */
-export declare class DaemonManager {
-    private daemons;
-    private orchestrator;
-    private specialists;
-    private botManager;
-    private options;
-    private botTypeMap;
-    private displayNameMap;
-    constructor(botManager: MultiBotManager, options: DaemonManagerOptions);
-    /**
-     * Get botType for a userId from the workspace config
-     */
-    private getBotType;
-    /**
-     * Get displayName for a userId from the workspace config (Agent Directory activity name)
-     * Falls back to Hailer profile name if not set
-     */
-    private getDisplayName;
-    /**
-     * Start all daemons (orchestrator + specialists)
-     */
-    startAll(): Promise<void>;
-    /**
-     * Orchestrator mode: one orchestrator (HAL) + specialist daemons
-     */
-    private startOrchestratorMode;
-    /**
-     * Stop all daemons
-     * Flushes session logs for each daemon before stopping
-     */
-    stopAll(): Promise<void>;
-    /**
-     * Get daemon for a specific bot
-     */
-    getDaemon(botId: string): ChatAgentDaemon | undefined;
-    /**
-     * Get status of all daemons
-     */
-    getStatus(): Array<{
-        botId: string;
-        state: ConversationState;
-    }>;
-    /**
-     * Log current status to console (for monitoring)
-     */
-    logStatus(): void;
-    /**
-     * Get orchestrator instance (only in orchestrator mode)
-     */
-    getOrchestrator(): OrchestratorDaemon | null;
-    /**
-     * Get specialist by key (only in orchestrator mode)
-     */
-    getSpecialist(key: string): SpecialistDaemon | undefined;
-    /**
-     * Check if running in orchestrator mode
-     */
-    isOrchestratorMode(): boolean;
-    /**
-     * Trigger HAL to respond in a discussion with context
-     */
-    triggerHalResponse(discussionId: string, activityId: string, context: string): Promise<void>;
-    /**
-     * Hot-reload: Start a specialist daemon dynamically
-     * Preserves orchestrator conversation context
-     */
-    startSpecialist(email: string, password: string, botType: string, userId?: string): Promise<boolean>;
-    /**
-     * Hot-reload: Stop a specialist daemon dynamically
-     * Preserves orchestrator conversation context
-     */
-    stopSpecialist(botType: string): Promise<boolean>;
-    /**
-     * Hot-reload a specialist (stop if running, start if enabled)
-     */
-    hotReloadSpecialist(email: string, password: string, botType: string, enabled: boolean, userId?: string): Promise<boolean>;
-    /**
-     * Start periodic status logging
-     */
-    startStatusLogging(intervalMs?: number): NodeJS.Timeout;
-}
-export interface CreateDaemonManagerOptions {
-    /** Enable orchestrator mode */
-    orchestratorMode?: boolean;
-    /** Email of orchestrator bot (defaults to first) */
-    orchestratorEmail?: string;
-    /** Map specialist keys to bot emails */
-    specialistEmails?: Record<string, string>;
-    /** Specific workspace ID to use (for webhook-triggered restarts) */
-    workspaceId?: string;
-}
-/**
- * Create and start the daemon manager
- * This is the main entry point for daemon mode
- *
- * @param options - Optional settings for orchestrator mode
- */
-export declare function createDaemonManager(options?: CreateDaemonManagerOptions): Promise<DaemonManager | null>;
-/**
- * Quick start function for testing
- *
- * @param orchestratorMode - Enable orchestrator mode (default: true)
- */
-export declare function startDaemonMode(orchestratorMode?: boolean): Promise<void>;
-//# sourceMappingURL=factory.d.ts.map