@hailer/mcp 0.1.17 → 0.2.2

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

@@ -1,207 +0,0 @@
-/**
- * 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