@hailer/mcp 1.2.1 → 2.0.0-beta.1

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

@@ -1,253 +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 { 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

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