@hailer/mcp 1.1.14 → 1.1.16

package/dist/bot-config/webhooks.js

@@ -0,0 +1,212 @@
+"use strict";
+/**
+ * Webhook Handlers
+ *
+ * Handles activity phase change signals from Hailer.
+ * Updates bot state when activities move between phases.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleActivityPhaseChange = handleActivityPhaseChange;
+exports.clearSignalCache = clearSignalCache;
+const logger_1 = require("../lib/logger");
+const context_1 = require("./context");
+const state_1 = require("./state");
+const logger = (0, logger_1.createLogger)({ component: 'BotWebhooks' });
+// Signal deduplication
+const processedSignals = new Map();
+const SIGNAL_DEDUP_WINDOW_MS = 5000;
+/**
+ * Check if a signal was recently processed (deduplication)
+ */
+function isDuplicateSignal(activityId, phaseId) {
+    const key = `${activityId}:${phaseId}`;
+    const now = Date.now();
+    const lastProcessed = processedSignals.get(key);
+    if (lastProcessed && now - lastProcessed < SIGNAL_DEDUP_WINDOW_MS) {
+        return true;
+    }
+    processedSignals.set(key, now);
+    // Cleanup old entries
+    if (processedSignals.size > 1000) {
+        const cutoff = now - SIGNAL_DEDUP_WINDOW_MS;
+        for (const [k, timestamp] of processedSignals) {
+            if (timestamp < cutoff) {
+                processedSignals.delete(k);
+            }
+        }
+    }
+    return false;
+}
+/**
+ * Handle activity phase change signal
+ *
+ * Called when an activity moves between phases in Hailer.
+ * Updates bot state if the activity belongs to Agent Directory.
+ */
+async function handleActivityPhaseChange(processId, activityIds, newPhaseId, client) {
+    // Look up which workspace this workflow belongs to
+    let botCtx = (0, context_1.getBotContextByWorkflowId)(processId);
+    // If no context found, try to auto-discover
+    if (!botCtx && client) {
+        logger.debug('Unknown workflow - attempting auto-discovery', { processId });
+        try {
+            const init = await client.fetchInit(['networks', 'network']);
+            const currentWorkspaceId = init?.network?._id;
+            if (currentWorkspaceId) {
+                // Try to initialize context from API
+                const ctx = (0, context_1.getBotContext)(currentWorkspaceId);
+                const success = await ctx.initializeFromApi(client);
+                if (success && ctx.getAgentDirectoryWorkflowId() === processId) {
+                    botCtx = ctx;
+                    logger.debug('Auto-discovered workspace for workflow', {
+                        workspaceId: currentWorkspaceId,
+                        processId
+                    });
+                }
+            }
+        }
+        catch (error) {
+            logger.warn('Auto-discovery failed', {
+                processId,
+                error: error instanceof Error ? error.message : String(error)
+            });
+        }
+    }
+    if (!botCtx) {
+        logger.debug('Skipping signal - workflow not an Agent Directory', { processId });
+        return;
+    }
+    const schema = botCtx.getSchema();
+    if (!schema) {
+        logger.debug('Skipping signal - no schema', { workspaceId: botCtx.workspaceId });
+        return;
+    }
+    const phaseIds = botCtx.getPhaseIds();
+    const isDeployed = phaseIds.deployed ? newPhaseId === phaseIds.deployed : false;
+    const isRetired = phaseIds.retired ? newPhaseId === phaseIds.retired : false;
+    if (!isDeployed && !isRetired) {
+        logger.debug('Skipping signal - phase not relevant', { newPhaseId });
+        return;
+    }
+    logger.debug('Processing Agent Directory signal', {
+        workspaceId: botCtx.workspaceId,
+        processId,
+        activityCount: activityIds.length,
+        newPhaseId,
+        isDeployed
+    });
+    for (const activityId of activityIds) {
+        // Deduplication check
+        if (isDuplicateSignal(activityId, newPhaseId)) {
+            logger.debug('Skipping duplicate signal', { activityId });
+            continue;
+        }
+        await processActivityChange(activityId, schema, botCtx.workspaceId, isDeployed, client);
+    }
+}
+/**
+ * Process a single activity change
+ */
+async function processActivityChange(activityId, schema, workspaceId, enabled, client) {
+    if (!client) {
+        logger.debug('No client for activity fetch', { activityId });
+        return;
+    }
+    try {
+        // Fetch the activity
+        const activity = await client.fetchActivityById(activityId);
+        if (!activity) {
+            logger.warn('Activity not found', { activityId });
+            return;
+        }
+        // Extract user ID from activity
+        const userId = extractUserIdFromActivity(activity, schema);
+        if (!userId) {
+            logger.debug('Activity has no user ID', { activityId });
+            return;
+        }
+        // Extract bot type
+        const botType = extractBotTypeFromActivity(activity, schema);
+        // Extract and update credentials
+        const creds = extractCredentialsFromActivity(activity, schema, workspaceId, enabled);
+        if (creds) {
+            const ctx = (0, context_1.getBotContext)(workspaceId);
+            ctx.updateCredentials(userId, creds);
+        }
+        // Update bot state
+        (0, state_1.setBotEnabled)(workspaceId, userId, enabled);
+        logger.info('Bot state updated from webhook', {
+            workspaceId,
+            activityId,
+            userId,
+            enabled,
+            botType
+        });
+        // If orchestrator state changes, trigger daemon restart
+        if (botType === 'orchestrator') {
+            logger.info('Orchestrator state changed via webhook');
+            (0, state_1.notifyDaemonRestartNeeded)();
+        }
+    }
+    catch (error) {
+        logger.warn('Failed to process activity change', {
+            activityId,
+            error: error instanceof Error ? error.message : String(error)
+        });
+    }
+}
+// ============================================================================
+// Extraction Helpers
+// ============================================================================
+/**
+ * Extract user ID from activity
+ */
+function extractUserIdFromActivity(activity, schema) {
+    const fields = activity.fields || {};
+    if (schema.fields.hailerProfile) {
+        return fields[schema.fields.hailerProfile] || null;
+    }
+    return null;
+}
+/**
+ * Extract bot type from activity
+ */
+function extractBotTypeFromActivity(activity, schema) {
+    const fields = activity.fields || {};
+    if (schema.fields.botType) {
+        return fields[schema.fields.botType] || null;
+    }
+    return null;
+}
+/**
+ * Extract credentials from activity
+ */
+function extractCredentialsFromActivity(activity, schema, workspaceId, enabled) {
+    const fields = activity.fields || {};
+    const email = schema.fields.email ? fields[schema.fields.email] : null;
+    const password = schema.fields.password ? fields[schema.fields.password] : null;
+    const systemPrompt = schema.fields.systemPrompt ? (fields[schema.fields.systemPrompt] || undefined) : undefined;
+    const accessLevel = schema.fields.accessLevel ? (fields[schema.fields.accessLevel] || undefined) : undefined;
+    if (!email || !password) {
+        return null;
+    }
+    return {
+        email,
+        password,
+        displayName: activity.name,
+        botType: extractBotTypeFromActivity(activity, schema),
+        systemPrompt,
+        accessLevel,
+        enabled,
+        workspaceId,
+        activityId: activity._id,
+    };
+}
+/**
+ * Clear signal deduplication cache
+ */
+function clearSignalCache() {
+    processedSignals.clear();
+    logger.debug('Signal cache cleared');
+}
+//# sourceMappingURL=webhooks.js.map

package/dist/bot-config/webhooks.js.map

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

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAiBA,OAAO,OAAO,CAAC"}

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;;AAEA,+DAA+D;AAC/D,wFAAwF;AACxF,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACnC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;IACrC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;QAC9D,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC/B,MAAM;IACR,CAAC;AACH,CAAC;AAED,4DAA4D;AAC5D,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC;IACrD,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;AACjD,CAAC;AAED,iBAAe"}

package/dist/client/agents/base.d.ts

@@ -0,0 +1,207 @@
+/**
+ * Chat Agent Daemon
+ *
+ * A persistent LLM conversation that monitors all workspace chats.
+ * The LLM maintains context across messages and decides what to respond to.
+ *
+ * Architecture:
+ * - One daemon per bot client
+ * - Subscribes to ALL messenger.new signals (not filtered)
+ * - LLM sees every message with priority markers
+ * - LLM decides: RESPOND / IGNORE / ACTION
+ */
+import Anthropic from "@anthropic-ai/sdk";
+import { BotClient } from "../bot-manager";
+import { HailerSignal } from "../../mcp/signal-handler";
+import { Logger } from "../../lib/logger";
+import { ToolSchemaLoader, ToolIndexEntry } from "../tool-schema-loader";
+import { ToolInput, McpToolResult } from "../types";
+import { AgentRegistryService } from "../services/agent-registry";
+import { ConversationManager, ConversationMessage } from "../services/conversation-manager";
+import { McpClientService } from "../services/mcp-client";
+import { MessageFormatterService } from "../services/message-formatter";
+import { MessageClassifier } from "../services/message-classifier";
+import { SessionLoggerService } from "../services/session-logger";
+import { ToolExecutor } from "../services/tool-executor";
+import { WorkspaceSchemaCacheService } from "../services/workspace-schema-cache";
+import { SessionMetrics, ActivitySession, MessagePriority, IncomingMessage, ConversationState } from "../types";
+export type { IncomingMessage, MessagePriority, SessionMetrics, ActivitySession };
+export interface ChatAgentDaemonConfig {
+    botClient: BotClient;
+    mcpServerUrl: string;
+    anthropicApiKey: string;
+    model?: string;
+    maxContextMessages?: number;
+}
+export declare class ChatAgentDaemon {
+    protected logger: Logger;
+    protected client: Anthropic;
+    protected botClient: BotClient;
+    protected config: ChatAgentDaemonConfig;
+    protected toolSchemaLoader: ToolSchemaLoader;
+    protected isProcessing: boolean;
+    protected messageQueue: IncomingMessage[];
+    protected processedMessageIds: Set<string>;
+    private typingInterval;
+    private typingDiscussionId;
+    private static TYPING_REFRESH_MS;
+    protected toolIndex: ToolIndexEntry[];
+    protected minimalTools: Anthropic.Tool[];
+    /** Message classifier - handles message extraction and priority classification */
+    protected messageClassifier: MessageClassifier | null;
+    /** Conversation manager - handles per-discussion context and LRU cache */
+    protected conversationManager: ConversationManager | null;
+    /** MCP client service - handles tool schema loading and execution */
+    protected mcpClient: McpClientService | null;
+    /** Tool executor - handles tool execution and write tracking */
+    protected toolExecutor: ToolExecutor | null;
+    /** Agent registration service - handles Agent Directory, Position, Team, etc. */
+    protected registryService: AgentRegistryService | null;
+    /** Message formatting service - handles tag resolution and formatting */
+    protected messageFormatter: MessageFormatterService | null;
+    /** Session logging service - handles activity session tracking */
+    protected sessionLogger: SessionLoggerService | null;
+    /** Workspace schema cache - dynamic workflow/field ID lookup */
+    protected schemaCache: WorkspaceSchemaCacheService | null;
+    /** Current discussion context for tracking */
+    protected currentDiscussionId: string | null;
+    protected currentLinkedActivityId: string | null;
+    constructor(config: ChatAgentDaemonConfig);
+    /**
+     * Initialize the daemon - load tools and subscribe to signals
+     */
+    initialize(): Promise<void>;
+    /**
+     * Extract and classify incoming message from signal
+     * Can be overridden in subclasses to customize filtering
+     */
+    protected extractIncomingMessage(signal: HailerSignal): Promise<IncomingMessage | null>;
+    /**
+     * Handle incoming signal from Hailer
+     */
+    private handleSignal;
+    /**
+     * Process queued messages through the LLM
+     * Note: Uses flag-first pattern to prevent race conditions
+     */
+    private processQueue;
+    /**
+     * Process a single message through the persistent LLM conversation
+     */
+    private processMessage;
+    /**
+     * Format incoming message for LLM consumption
+     */
+    private formatIncomingMessage;
+    /**
+     * Load and inject memory for an activity into conversation context
+     * Called when entering a new discussion that's linked to an activity
+     */
+    private injectMemoryForActivity;
+    /**
+     * Execute tool calls and continue the conversation
+     * Simple passthrough - just execute tools and return results to LLM
+     */
+    protected executeToolsAndContinue(toolUseBlocks: Anthropic.ToolUseBlock[], originalMessage: IncomingMessage): Promise<void>;
+    /**
+     * Handle LLM response
+     * Override in subclasses to customize response handling
+     */
+    protected handleLlmResponse(response: Anthropic.Message, originalMessage: IncomingMessage): Promise<void>;
+    /**
+     * Start typing indicator with auto-refresh interval
+     * Keeps refreshing every 3 seconds until stopTypingIndicator is called
+     */
+    protected startTypingIndicator(discussionId: string): void;
+    /**
+     * Stop typing indicator and clear refresh interval
+     */
+    protected stopTypingIndicator(): void;
+    /**
+     * Send typing signal to Hailer API
+     * API: messenger.set_discussion_typing_state(discussionId, typingState)
+     */
+    private sendTypingSignal;
+    /**
+     * Post a response to a discussion
+     * Automatically converts @mentions and #activity tags to Hailer tags
+     * Includes links metadata required for tags to work
+     */
+    protected postResponse(discussionId: string, content: string): Promise<void>;
+    /**
+     * Get the system prompt for the daemon
+     * MUST be overridden in subclasses
+     */
+    protected getSystemPrompt(): string;
+    /**
+     * Get tools for LLM calls
+     * Override in subclass to add custom tools (like trigger_giuseppe_retry)
+     */
+    protected getTools(): Anthropic.Tool[];
+    /**
+     * Get tool whitelist for this agent
+     * Override in subclass to limit which tools are available
+     * Return null for all tools, or array of tool names
+     */
+    protected getToolWhitelist(): string[] | null;
+    /**
+     * Preprocess tool input before execution
+     * Override in subclass to inject context (e.g., sourceActivityId)
+     * @param toolName - Name of the tool being called
+     * @param input - Original tool input from LLM
+     * @returns Processed input (may be modified)
+     */
+    protected preprocessToolInput(toolName: string, input: ToolInput): ToolInput;
+    /**
+     * Call MCP tool (delegates to McpClientService)
+     * Protected for subclass access
+     */
+    protected callMcpTool(name: string, args: ToolInput): Promise<McpToolResult>;
+    /**
+     * Stop the daemon
+     * Flushes all pending activity sessions before stopping
+     */
+    stop(): Promise<void>;
+    /**
+     * Get current conversation state (for debugging)
+     */
+    getConversationState(): ConversationState;
+    /**
+     * Get full conversation for a specific discussion (for debugging)
+     */
+    getFullConversation(discussionId?: string): ConversationMessage[];
+    /**
+     * Get agent's display name (override in subclass for custom names)
+     * Default implementation uses the actual Hailer user name from BotClient
+     */
+    protected getAgentName(): {
+        firstName: string;
+        lastName: string;
+    };
+    /**
+     * Get agent's description/system prompt (override in subclass)
+     */
+    protected getAgentDescription(): string;
+    /**
+     * Get default team ID from workspace cache
+     * Returns the first available team, or undefined if no teams exist
+     *
+     * Teams structure in init is: { teams: { workspaceId: { teamId: teamData, ... } } }
+     */
+    protected getDefaultTeamId(): string | undefined;
+    /**
+     * Get agent's Position details (override in subclass for custom positions)
+     */
+    protected getPositionDetails(): {
+        name: string;
+        purpose: string;
+        personaTone: string;
+        coreCapabilities: string;
+        boundaries: string;
+    };
+    /**
+     * Get agent directory ID
+     */
+    getAgentDirectoryId(): string | null;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/client/agents/base.d.ts.map

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