@hailer/mcp 0.1.8 → 0.1.9

package/dist/client/chat-agent-daemon.d.ts

@@ -0,0 +1,464 @@
+/**
+ * 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 } from "./tool-schema-loader";
+/** Agent Directory workflow - registry of all bot agents */
+export declare const AGENT_DIRECTORY: {
+    readonly workflowId: "694a35b5b8b5c5f8030788e3";
+    readonly phases: {
+        readonly agentBuilder: "694a35b5b8b5c5f8030788f7";
+        readonly deployed: "694a35b5b8b5c5f8030788fb";
+        readonly retired: "694a35b5b8b5c5f8030788fc";
+    };
+    readonly fields: {
+        readonly firstName: "694a35b5b8b5c5f8030788ea";
+        readonly lastName: "694a35b5b8b5c5f8030788eb";
+        readonly description: "694a35b5b8b5c5f8030788f6";
+        readonly hailerProfile: "694a35b5b8b5c5f8030788f2";
+        readonly email: "694a35b5b8b5c5f8030788f3";
+        readonly password: "694a35b5b8b5c5f8030788f4";
+        readonly team: "694a35b5b8b5c5f8030788e7";
+        readonly supervisor: "694a35b5b8b5c5f8030788e8";
+        readonly memory: "694a35b5b8b5c5f8030788f5";
+        readonly position: "694a35b5b8b5c5f8030788e5";
+        readonly startDate: "694a35b5b8b5c5f8030788ec";
+    };
+};
+/** Session Log workflow - tracks agent actions */
+export declare const SESSION_LOG: {
+    readonly workflowId: "694a35b5b8b5c5f803078915";
+    readonly phases: {
+        readonly active: "694a35b5b8b5c5f803078941";
+        readonly archive: "694a35b5b8b5c5f803078942";
+    };
+    readonly fields: {
+        readonly contextSummary: "694a35b5b8b5c5f80307893c";
+        readonly previousLog: "694a35b5b8b5c5f80307893d";
+        readonly linkedWork: "694a35b5b8b5c5f80307893e";
+        readonly cost: "694a35b5b8b5c5f80307893f";
+        readonly madeBy: "694a35b5b8b5c5f803078940";
+    };
+};
+/** Positions workflow - job descriptions/roles for agents */
+export declare const POSITIONS: {
+    readonly workflowId: "694a35b5b8b5c5f8030788e4";
+    readonly phases: {
+        readonly active: "694a35b5b8b5c5f80307890f";
+    };
+    readonly fields: {
+        readonly purpose: "694a35b5b8b5c5f803078901";
+        readonly personaTone: "694a35b5b8b5c5f803078903";
+        readonly coreCapabilities: "694a35b5b8b5c5f803078904";
+        readonly contextAwareness: "694a35b5b8b5c5f803078905";
+        readonly taskHandling: "694a35b5b8b5c5f803078906";
+        readonly infoRetrieval: "694a35b5b8b5c5f803078907";
+        readonly boundaries: "694a35b5b8b5c5f803078908";
+        readonly userInteraction: "694a35b5b8b5c5f803078909";
+        readonly errorHandling: "694a35b5b8b5c5f80307890a";
+        readonly learning: "694a35b5b8b5c5f80307890b";
+        readonly escalation: "694a35b5b8b5c5f80307890c";
+        readonly auditLogging: "694a35b5b8b5c5f80307890d";
+        readonly agentCount: "694a35b5b8b5c5f803078902";
+        readonly multiAllowed: "694a35b5b8b5c5f80307890e";
+    };
+};
+/** Teams workflow - groups of agents */
+export declare const TEAMS: {
+    readonly workflowId: "694a35b5b8b5c5f8030788e6";
+    readonly phases: {
+        readonly active: "694a35b5b8b5c5f80307891a";
+    };
+    readonly fields: {
+        readonly info: "694a35b5b8b5c5f803078919";
+        readonly leader: "694a35b5b8b5c5f8030788e9";
+    };
+};
+/** Tool Registry workflow - MCP server configurations */
+export declare const TOOL_REGISTRY: {
+    readonly workflowId: "694a35b5b8b5c5f803078922";
+    readonly phases: {
+        readonly active: "694a35b5b8b5c5f803078927";
+    };
+    readonly fields: {
+        readonly baseUrl: "694a35b5b8b5c5f803078923";
+        readonly protocolVersion: "694a35b5b8b5c5f803078924";
+        readonly toolRegistry: "694a35b5b8b5c5f803078925";
+        readonly logEntryBy: "694a35b5b8b5c5f803078926";
+    };
+};
+/** MCP Config workflow - per-agent MCP configuration */
+export declare const MCP_CONFIG: {
+    readonly workflowId: "694a35b5b8b5c5f803078928";
+    readonly phases: {
+        readonly active: "694a35b5b8b5c5f80307893b";
+    };
+    readonly fields: {
+        readonly agentName: "694a35b5b8b5c5f803078929";
+        readonly agentId: "694a35b5b8b5c5f80307892a";
+        readonly publicKey: "694a35b5b8b5c5f80307892c";
+        readonly accessTo: "694a35b5b8b5c5f80307892b";
+        readonly authToken: "694a35b5b8b5c5f80307892d";
+        readonly apiKey: "694a35b5b8b5c5f80307892e";
+        readonly workspaceId: "694a35b5b8b5c5f803078934";
+        readonly permissions: "694a35b5b8b5c5f803078935";
+        readonly sessionId: "694a35b5b8b5c5f803078936";
+        readonly resourceLimits: "694a35b5b8b5c5f803078937";
+        readonly loggingEndpoint: "694a35b5b8b5c5f803078938";
+        readonly callbackUrl: "694a35b5b8b5c5f803078939";
+        readonly customContext: "694a35b5b8b5c5f80307893a";
+        readonly permCreate: "694a35b5b8b5c5f803078930";
+        readonly permRead: "694a35b5b8b5c5f803078931";
+        readonly permUpdate: "694a35b5b8b5c5f803078932";
+        readonly permDelete: "694a35b5b8b5c5f803078933";
+    };
+};
+/** Session usage metrics */
+export interface SessionMetrics {
+    inputTokens: number;
+    outputTokens: number;
+    toolCalls: number;
+    messagesProcessed: number;
+    responsesPosted: number;
+}
+/** Per-activity session tracking */
+export interface ActivitySession {
+    activityId: string;
+    activityName: string;
+    discussionId: string;
+    startTime: number;
+    lastActivityTime: number;
+    metrics: SessionMetrics;
+    actions: string[];
+    previousLogId: string | null;
+    /** Compact conversation log: "User: ...", "Bot: ..." */
+    conversation: string[];
+}
+export type MessagePriority = "high" | "normal" | "low";
+export interface IncomingMessage {
+    id: string;
+    discussionId: string;
+    discussionName?: string;
+    linkedActivityId?: string;
+    linkedActivityName?: string;
+    senderId: string;
+    senderName: string;
+    content: string;
+    timestamp: number;
+    priority: MessagePriority;
+    priorityReason: string;
+    isReplyToBot: boolean;
+    isMention: boolean;
+    isDirectMessage: boolean;
+}
+export type LlmDecision = {
+    action: "respond";
+    discussionId: string;
+    content: string;
+} | {
+    action: "ignore";
+    reason: string;
+} | {
+    action: "tool_call";
+    toolName: string;
+    args: any;
+} | {
+    action: "thinking";
+    content: string;
+};
+interface ConversationMessage {
+    role: "user" | "assistant";
+    content: string | any[];
+}
+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 conversationMessages: ConversationMessage[];
+    protected isProcessing: boolean;
+    protected messageQueue: IncomingMessage[];
+    protected processedMessageIds: Set<string>;
+    protected toolIndex: any[];
+    protected minimalTools: any[];
+    protected loadedToolSchemas: Map<string, any>;
+    /** This agent's activity ID in the Agent Directory */
+    protected agentDirectoryId: string | null;
+    /** This agent's Position activity ID */
+    protected positionId: string | null;
+    /** Shared Team activity ID for AI agents */
+    protected teamId: string | null;
+    /** MCP Server Tool Registry activity ID (shared) */
+    protected toolRegistryId: string | null;
+    /** This agent's MCP Config activity ID */
+    protected mcpConfigId: string | null;
+    /** Per-activity session tracking (activityId -> session) */
+    protected activitySessions: Map<string, ActivitySession>;
+    /** Global session log chain ID (for overall continuity) */
+    protected lastGlobalLogId: string | null;
+    /** Timer for checking idle sessions */
+    protected idleCheckTimer: NodeJS.Timeout | 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>;
+    /**
+     * Handle incoming signal from Hailer
+     */
+    private handleSignal;
+    /**
+     * Extract and classify incoming message from signal
+     * Override in subclasses to customize message filtering
+     */
+    protected extractIncomingMessage(signal: HailerSignal): Promise<IncomingMessage | null>;
+    /**
+     * Check if message mentions this bot
+     */
+    private checkMention;
+    /**
+     * Check if message is a reply to one of our messages
+     */
+    private checkReplyToBot;
+    /**
+     * Check if this is a 1:1 DM with the bot
+     */
+    private checkDirectMessage;
+    /**
+     * Get user's display name from workspace cache
+     */
+    private getUserDisplayName;
+    /**
+     * Format a Hailer tag for mentioning a user or activity
+     * Hailer requires ZWNBSP (U+FEFF) around the tag
+     */
+    private formatHailerTag;
+    /**
+     * Extract link metadata from hailerTag formatted content
+     * Returns array of links for the messenger.send API
+     */
+    private extractTagLinks;
+    /**
+     * Look up user by ID and create a Hailer tag
+     */
+    private createUserTagById;
+    /**
+     * Look up user by name and create a Hailer tag
+     */
+    private createUserTagByName;
+    /**
+     * Convert @mentions and #activity tags in response to Hailer tags
+     * Supports:
+     * - @userId (24-char hex MongoDB ID) → user tag
+     * - @"Full Name" (quoted name lookup) → user tag
+     * - @FirstName (single word name lookup) → user tag
+     * - #activityId (24-char hex) → activity tag
+     * - #"Activity Name" (quoted) → activity tag (requires lookup)
+     */
+    private convertMentionsToTags;
+    /**
+     * Resolve user tags - look up names for IDs via API when not in cache
+     * Handles @userId (24-char hex) format
+     */
+    private resolveUserTags;
+    /**
+     * Resolve activity tags - look up names for IDs and IDs for names
+     * Handles both #activityId and #"Activity Name" formats
+     */
+    private resolveActivityTags;
+    /**
+     * Process queued messages through the LLM
+     */
+    private processQueue;
+    /**
+     * Process a single message through the persistent LLM conversation
+     */
+    private processMessage;
+    /**
+     * Format incoming message for LLM consumption
+     */
+    private formatIncomingMessage;
+    /**
+     * 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>;
+    /**
+     * 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>;
+    /**
+     * Manage conversation context size - summarize if too large
+     */
+    private manageContextSize;
+    /**
+     * Get the system prompt for the daemon
+     * MUST be overridden in subclasses
+     */
+    protected getSystemPrompt(): string;
+    /**
+     * Fetch tool schema from MCP server
+     */
+    private fetchToolSchema;
+    /**
+     * Call MCP tool
+     */
+    protected callMcpTool(name: string, args: any): Promise<any>;
+    /**
+     * Stop the daemon
+     * Flushes all pending activity sessions before stopping
+     */
+    stop(): Promise<void>;
+    /**
+     * Get current conversation state (for debugging)
+     */
+    getConversationState(): {
+        messageCount: number;
+        queueLength: number;
+        lastMessages: Array<{
+            role: string;
+            preview: string;
+            timestamp?: string;
+        }>;
+        isProcessing: boolean;
+    };
+    /**
+     * Get full conversation for deep debugging
+     */
+    getFullConversation(): ConversationMessage[];
+    /**
+     * Get agent's display name (override in subclass for custom names)
+     */
+    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;
+    /**
+     * Register this agent in the Agent Directory
+     * Called during initialize() - finds existing entry or creates new one
+     */
+    protected registerAgentInDirectory(): Promise<void>;
+    /**
+     * Find existing agent entry by email
+     */
+    private findAgentByEmail;
+    /**
+     * Update agent's Hailer profile reference
+     */
+    private updateAgentProfile;
+    /**
+     * Register all agent data across all workflows
+     * Orchestrates: Agent Directory, Position, Team, Tool Registry, MCP Config
+     */
+    protected registerAllAgentData(): Promise<void>;
+    /**
+     * Get agent's Position details (override in subclass for custom positions)
+     */
+    protected getPositionDetails(): {
+        name: string;
+        purpose: string;
+        personaTone: string;
+        coreCapabilities: string;
+        boundaries: string;
+    };
+    /**
+     * Register/find shared Team for AI agents
+     */
+    protected registerTeam(): Promise<void>;
+    /**
+     * Register MCP server in Tool Registry
+     */
+    protected registerToolRegistry(): Promise<void>;
+    /**
+     * Register Position for this agent
+     */
+    protected registerPosition(): Promise<void>;
+    /**
+     * Register MCP Config for this agent
+     */
+    protected registerMcpConfig(): Promise<void>;
+    /**
+     * Link Agent Directory entry to Position and Team
+     */
+    protected linkAgentToPositionAndTeam(): Promise<void>;
+    /**
+     * Extract activity ID from MCP tool response text
+     */
+    private extractActivityId;
+    /**
+     * Get or create an activity session for tracking
+     */
+    protected getOrCreateActivitySession(message: IncomingMessage): ActivitySession;
+    /**
+     * Check for idle sessions and flush them
+     * Called periodically by timer
+     */
+    protected checkAndFlushIdleSessions(): Promise<void>;
+    /**
+     * Flush a single activity session to the session log
+     */
+    protected flushActivitySession(key: string, session: ActivitySession): Promise<void>;
+    /**
+     * Flush all active sessions (called on shutdown)
+     */
+    protected flushAllSessions(): Promise<void>;
+    /**
+     * Build summary for an activity session
+     */
+    private buildActivitySessionSummary;
+    /**
+     * Generate brief summary from session actions
+     */
+    private generateBriefSummaryFromActions;
+    /**
+     * Get all active session metrics (for monitoring)
+     */
+    getActiveSessions(): Map<string, ActivitySession>;
+    /**
+     * Get agent directory ID
+     */
+    getAgentDirectoryId(): string | null;
+}
+export {};
+//# sourceMappingURL=chat-agent-daemon.d.ts.map