@hailer/mcp 0.1.17 → 0.2.1

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

@@ -1,464 +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 } 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