@hailer/mcp 1.1.15 → 1.1.16

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

@@ -0,0 +1,253 @@
+/**
+ * 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 { ToolGroup } from "../../mcp/tool-registry";
+import { ToolInput, McpToolResult } from "./types";
+import { AgentRegistryService } from "./services/agent-registry";
+import { ConversationManager } 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 { TypingIndicatorService } from "./services/typing-indicator";
+import { TokenBillingService } from "./services/token-billing";
+import { StructuredOutputExecutor } from "./services/structured-output-executor";
+import { BotAction } from "./schemas/action-schema";
+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;
+    /**
+     * Use structured outputs instead of native tools
+     * Saves ~100K tokens per request by not sending tool schemas
+     * Requires anthropic-beta: structured-outputs-2025-11-13
+     */
+    useStructuredOutputs?: boolean;
+}
+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>;
+    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;
+    /** Typing indicator service - handles typing state with auto-refresh */
+    protected typingIndicator: TypingIndicatorService | null;
+    /** Token billing service - handles real-time token burning per workspace */
+    protected tokenBilling: TokenBillingService | null;
+    /** Structured output executor - handles action-based output instead of native tools */
+    protected structuredOutputExecutor: StructuredOutputExecutor | null;
+    /** Current discussion context for tracking */
+    protected currentDiscussionId: string | null;
+    protected currentLinkedActivityId: string | null;
+    /** Unsubscribe function for messenger.new signals */
+    private messengerUnsubscribe;
+    /** Original API key for cleanup - stored at init because botClient.config may change */
+    private originalApiKey;
+    constructor(config: ChatAgentDaemonConfig);
+    /**
+     * Get the workspace schema cache for dynamic workflow/field ID lookup
+     * Exposed for modules that need to share schema discovery (e.g., Bug Fixer)
+     */
+    getSchemaCache(): WorkspaceSchemaCacheService | null;
+    /**
+     * 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 memory context on cold start
+     * Uses discussion message history (FREE) instead of SESSION_LOG (costs tokens)
+     */
+    private loadMemoryContext;
+    /**
+     * Execute tool calls and continue the conversation
+     * Simple passthrough - just execute tools and return results to LLM
+     * @param conversationLengthBeforeMessage - passed through for proper IGNORE cleanup
+     */
+    protected executeToolsAndContinue(toolUseBlocks: Anthropic.ToolUseBlock[], originalMessage: IncomingMessage, conversationLengthBeforeMessage?: number): Promise<void>;
+    /**
+     * Handle LLM response
+     * Override in subclasses to customize response handling
+     * @param conversationLengthBeforeMessage - length to truncate to on IGNORE (cleans up entire tool loop)
+     */
+    protected handleLlmResponse(response: Anthropic.Message, originalMessage: IncomingMessage, conversationLengthBeforeMessage?: number): Promise<void>;
+    /**
+     * Call LLM with structured outputs instead of native tools
+     * Saves ~100K tokens per request by not sending tool schemas
+     */
+    protected callLlmWithStructuredOutputs(messages: Anthropic.MessageParam[]): Promise<Anthropic.Message>;
+    /**
+     * Handle structured output response
+     * Parses JSON action and executes it
+     */
+    protected handleStructuredResponse(response: Anthropic.Message, originalMessage: IncomingMessage, conversationLengthBeforeMessage?: number): Promise<void>;
+    /**
+     * Continue executing actions until a terminal action
+     */
+    protected executeStructuredActionLoop(originalMessage: IncomingMessage, conversationLengthBeforeMessage?: number): Promise<void>;
+    /**
+     * Get allowed actions for this agent
+     * Override in subclass to customize available actions
+     */
+    protected getAllowedActions(): BotAction[];
+    /**
+     * Handle specialist invitation
+     * Override in subclass (e.g., HAL daemon) to implement specialist logic
+     */
+    protected handleSpecialistInvite(specialistKey: string, context: string | undefined, originalMessage: IncomingMessage): Promise<void>;
+    /**
+     * 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>;
+    /**
+     * Send insufficient balance message to user
+     * Can be overridden in subclasses to customize the message
+     */
+    protected sendInsufficientBalanceMessage(discussionId: string): Promise<void>;
+    /**
+     * Get the system prompt for the daemon
+     * MUST be overridden in subclasses
+     */
+    protected getSystemPrompt(): string;
+    /**
+     * Get the system prompt wrapped with Anthropic prompt caching
+     * This enables 50% cost reduction on cached tokens after first use
+     */
+    protected getCachedSystemPrompt(): Anthropic.TextBlockParam[];
+    /**
+     * Get tools for LLM calls
+     * Override in subclass to add custom tools (like trigger_giuseppe_retry)
+     */
+    protected getTools(): Anthropic.Tool[];
+    /**
+     * Get tool groups to load for this agent
+     * Override in subclass to include additional groups (e.g., BOT_INTERNAL)
+     */
+    protected getToolGroups(): ToolGroup[];
+    /**
+     * 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 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/agents/shared/base.d.ts.map

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