@hailer/mcp 1.1.14 → 1.1.16

package/dist/agents/shared/specialist.js

@@ -0,0 +1,399 @@
+"use strict";
+/**
+ * Specialist Daemon
+ *
+ * A lightweight daemon for specialist bots that only responds when @mentioned.
+ * Specialists are invited to discussions by the orchestrator (HAL) to handle
+ * specific complex tasks.
+ *
+ * Key differences from ChatAgentDaemon:
+ * - Only responds when @mentioned (not all messages)
+ * - Has specialized system prompt from Specialist config
+ * - More tool-focused, less conversational
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SpecialistDaemon = void 0;
+const base_1 = require("./base");
+const logger_1 = require("../../lib/logger");
+class SpecialistDaemon extends base_1.ChatAgentDaemon {
+    specialistLogger;
+    specialist;
+    lastResponseTime = 0;
+    minResponseGap = 2000; // 2 seconds minimum between responses
+    constructor(config) {
+        super(config);
+        this.specialist = config.specialist;
+        this.specialistLogger = (0, logger_1.createLogger)({
+            component: "SpecialistDaemon",
+            botId: config.botClient.userId,
+            specialistName: config.specialist.name,
+        });
+    }
+    // ===== AGENT DIRECTORY OVERRIDES =====
+    /**
+     * Override agent name for Agent Directory - uses specialist's configured name
+     */
+    getAgentName() {
+        const nameParts = this.specialist.name.split(" ");
+        const firstName = nameParts[0] || "Specialist";
+        const lastName = nameParts.slice(1).join(" ") || "Bot";
+        return { firstName, lastName };
+    }
+    /**
+     * Override agent description for Agent Directory - uses specialist's expertise
+     */
+    getAgentDescription() {
+        return `${this.specialist.name} - Specialist bot.\n\nExpertise: ${this.specialist.expertise.join(", ")}\n\n${this.specialist.systemPrompt.substring(0, 500)}...`;
+    }
+    /**
+     * Override Position details for Specialist - uses specialist's expertise
+     */
+    getPositionDetails() {
+        return {
+            name: `${this.specialist.name} Position`,
+            purpose: `Specialist bot for: ${this.specialist.expertise.join(", ")}`,
+            personaTone: "Technical, precise, and data-focused. Responds with structured results.",
+            coreCapabilities: this.specialist.expertise.map(e => `- ${e}`).join("\n"),
+            boundaries: "- Only respond when explicitly @mentioned\n- Never fabricate data - always use tools\n- Stay focused on specialty area\n- Hand back to orchestrator when done",
+        };
+    }
+    /**
+     * Specialist gets more tools for complex operations
+     */
+    getToolWhitelist() {
+        return [
+            // All orchestrator tools
+            "list_workflows",
+            "list_workflow_phases",
+            "get_workflow_schema",
+            "list_workflows_minimal",
+            "list_activities",
+            "show_activity_by_id",
+            "count_activities",
+            "create_activity",
+            "update_activity",
+            "join_discussion",
+            "add_discussion_message",
+            "invite_discussion_members",
+            "fetch_discussion_messages",
+            "get_activity_from_discussion",
+            "list_my_discussions",
+            "search_workspace_users",
+            // Insight tools
+            "list_insights",
+            "get_insight_data",
+            "preview_insight",
+            "create_insight",
+            "update_insight",
+            "remove_insight",
+            // Workflow config
+            "update_workflow_field",
+            "update_workflow_phase",
+            "install_workflow",
+            "remove_workflow",
+            // Template tools
+            "list_templates",
+            "get_template",
+            "create_template",
+            "install_template",
+            // Other
+            "upload_files",
+            "test_function_field",
+        ];
+    }
+    /**
+     * Force compact output for schema tools (avoid verbose field dumps in discussions)
+     */
+    preprocessToolInput(toolName, input) {
+        if (toolName === "get_workflow_schema") {
+            return { ...input, compact: true };
+        }
+        return input;
+    }
+    /**
+     * Override to only process messages where we're @mentioned
+     */
+    async extractIncomingMessage(signal) {
+        // Get base message extraction
+        const message = await super.extractIncomingMessage(signal);
+        if (!message)
+            return null;
+        // Specialists only respond when mentioned
+        if (!this.isMentionedInMessage(message)) {
+            this.specialistLogger.debug("Message doesn't mention specialist, ignoring", {
+                discussion: message.discussionId,
+                from: message.senderName,
+            });
+            return null;
+        }
+        // Rate limit responses
+        const now = Date.now();
+        if (now - this.lastResponseTime < this.minResponseGap) {
+            this.specialistLogger.debug("Rate limiting specialist response", {
+                timeSinceLastResponse: now - this.lastResponseTime,
+            });
+            return null;
+        }
+        // Mark as high priority since we're explicitly mentioned
+        message.priority = "high";
+        message.priorityReason = `Specialist ${this.specialist.name} was tagged`;
+        this.specialistLogger.info("Specialist mentioned, processing message", {
+            discussion: message.discussionId,
+            from: message.senderName,
+            preview: message.content.substring(0, 50),
+        });
+        return message;
+    }
+    /**
+     * Check if this specialist is mentioned in the message
+     * Supports various mention formats:
+     * - @"Specialist Name"
+     * - @SpecialistName (no spaces)
+     * - Direct user tag [hailerTag|Name](userId)
+     */
+    isMentionedInMessage(message) {
+        const content = message.content;
+        const name = this.specialist.name;
+        const userId = this.botClient.userId;
+        // Check for hailerTag mention (most reliable)
+        const hailerTagPattern = new RegExp(`\\[hailerTag\\|[^\\]]*\\]\\(${userId}\\)`, "i");
+        if (hailerTagPattern.test(content)) {
+            return true;
+        }
+        // Check for @"Name" mention
+        if (content.includes(`@"${name}"`)) {
+            return true;
+        }
+        // Check for @Name (no spaces version)
+        const nameNoSpaces = name.replace(/\s+/g, "");
+        if (content.includes(`@${nameNoSpaces}`)) {
+            return true;
+        }
+        // Check for @Name (first word)
+        const firstName = name.split(" ")[0];
+        if (content.includes(`@${firstName}`)) {
+            return true;
+        }
+        // Check message.isMention (set by parent class)
+        if (message.isMention) {
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Override system prompt with specialist-specific prompt
+     */
+    getSystemPrompt() {
+        const now = new Date();
+        return `${this.specialist.systemPrompt}
+
+<current_time>${now.toISOString()}</current_time>
+
+<bot_info>
+Bot ID: ${this.botClient.userId}
+Name: ${this.specialist.name}
+</bot_info>
+
+<response_rules>
+- You were invited to this discussion to help with a specific task
+- Read HAL's handoff message to understand what's needed
+- Use MCP tools to complete the task - NEVER fabricate data
+- Respond with clear, structured results
+- Include activity links using #activityId format
+- Be concise and technical - data first, explanation second
+</response_rules>
+
+<tool_parameters>
+<context_ids>
+Extract IDs from the incoming tag and HAL's handoff:
+- activityId attribute → show_activity_by_id, update_activity
+- discussionId attribute → get_activity_from_discussion
+- workflowId, fieldId → insight tools
+</context_ids>
+
+<never_do>
+- Call tools with empty parameters {}
+- Use field LABELS as fieldIds (fieldId must be 24-char hex)
+- Guess IDs - always extract from context
+</never_do>
+
+<update_activity_formats>
+- Single mode: use activityId parameter
+- Bulk mode: use _id inside activities array (NOT activityId)
+</update_activity_formats>
+
+<field_values>
+- numericunit: 78 (NOT {"type":"numericunit","value":78})
+- activitylink: "abc123..." (NOT {"_id":"abc123","name":"..."})
+</field_values>
+</tool_parameters>
+
+<insight_tools>
+<critical>
+- fieldId MUST be 24-character hex ID, NOT the field label!
+- Field names must be SQL-safe: no spaces (use camelCase)
+</critical>
+
+<create_insight_format>
+sources: [{
+  name: "tableAlias",
+  workflowId: "691ffdf84217e9e8434e56ad",
+  fields: [
+    { name: "playerName", fieldId: "691ffdf84217e9e8434e56b1" },
+    { name: "injuryType", fieldId: "691ffdf84217e9e8434e56b2" }
+  ]
+}]
+</create_insight_format>
+
+<hailer_sql_syntax>
+Hailer insights: fields are mapped in sources.fields, then referenced by ALIAS in query.
+
+HOW IT WORKS:
+1. Define fields in sources: { name: "playerName", fieldId: "691fff..." }
+2. Use the NAME (alias) in SQL: SELECT playerName FROM tableName
+
+SELECT columns - use the field ALIAS names you defined:
+- playerName, injuryType    ← custom fields (by alias)
+- name                       ← built-in activity name
+
+Column aliases with spaces need quotes:
+- playerName as "Player Name"
+- injuryType as "Injury Type"
+
+LIMITATIONS - DO NOT USE:
+- Phase filtering (no _phase column)
+- Date functions like NOW(), date('now'), CURRENT_DATE
+- Complex WHERE clauses with dates
+
+Keep queries SIMPLE: SELECT, FROM, basic WHERE (string comparisons), ORDER BY.
+Users can filter via UI "Show Filters" button.
+</hailer_sql_syntax>
+
+<correct_query_example>
+sources: [{
+  name: "injuries",
+  workflowId: "691ffdf84217e9e8434e56ad",
+  fields: [
+    { name: "playerName", fieldId: "691ffdf84217e9e8434e5694" },
+    { name: "injuryType", fieldId: "691ffdf84217e9e8434e5695" }
+  ]
+}]
+
+query: "SELECT playerName as \\"Player\\", injuryType as \\"Injury Type\\" FROM injuries ORDER BY playerName ASC"
+
+WRONG (will fail):
+- WHERE expectedRecovery > date('now')
+- WHERE _phase = 'phaseId'
+- SELECT FIELD(fieldId) as column
+</correct_query_example>
+
+<where_to_get_ids>
+HAL's handoff contains workflowId, fieldIds, and phaseIds. Use them exactly.
+If not provided, call get_workflow_schema AND list_workflow_phases.
+</where_to_get_ids>
+</insight_tools>
+
+<response_format>
+When you complete a task, respond with:
+<respond discussion="DISCUSSION_ID">
+[Status emoji] [Brief summary]
+
+**What I did:**
+- Step 1: ...
+- Step 2: ...
+
+**Results:**
+[Data, links, or confirmation]
+
+**Next steps (if applicable):**
+[Suggestions for follow-up]
+</respond>
+
+If you need clarification:
+<respond discussion="DISCUSSION_ID">
+I need more information to complete this task:
+- Question 1?
+- Question 2?
+</respond>
+</response_format>`;
+    }
+    /**
+     * Track response time for rate limiting
+     */
+    async postResponse(discussionId, content) {
+        await super.postResponse(discussionId, content);
+        this.lastResponseTime = Date.now();
+    }
+    /**
+     * Get specialist status
+     */
+    getSpecialistStatus() {
+        return {
+            name: this.specialist.name,
+            expertise: this.specialist.expertise,
+            conversationState: this.getConversationState(),
+            lastResponseTime: this.lastResponseTime,
+        };
+    }
+    /**
+     * Trigger specialist to respond in a discussion with specific context
+     * Used for proactive responses (e.g., bug detection triggering Giuseppe)
+     */
+    async respondWithContext(discussionId, activityId, contextMessage) {
+        this.specialistLogger.info('Triggering contextual response', { discussionId, activityId });
+        try {
+            // Join the discussion first using MCP tool
+            // Note: join_discussion expects activityId to find the linked discussion
+            const joinResult = await this.callMcpTool("join_discussion", { activityId });
+            const joinResultText = joinResult?.content?.[0]?.text || '';
+            this.specialistLogger.debug('Join discussion result', {
+                activityId,
+                resultPreview: joinResultText.substring(0, 200)
+            });
+            // Get workspace ID from bot client cache
+            const workspaceId = this.botClient.workspaceCache?.currentWorkspace?._id || '';
+            if (!workspaceId) {
+                this.specialistLogger.warn('No workspace ID available from cache');
+            }
+            // Create a synthetic incoming message with the context
+            const syntheticMessage = {
+                id: `synthetic-${Date.now()}`,
+                discussionId,
+                linkedActivityId: activityId,
+                workspaceId,
+                content: contextMessage,
+                senderName: 'System',
+                senderId: 'system',
+                timestamp: Date.now(),
+                priority: 'high',
+                priorityReason: 'system_notification',
+                isReplyToBot: false,
+                isMention: true, // Treat as mention so specialist responds
+                isDirectMessage: false,
+            };
+            this.specialistLogger.info('Queuing synthetic message for LLM pipeline', {
+                discussionId,
+                activityId,
+                contentLength: contextMessage.length
+            });
+            // Process through normal LLM pipeline
+            await this['processMessage'](syntheticMessage);
+            this.specialistLogger.info('Contextual response completed', { discussionId, activityId });
+        }
+        catch (error) {
+            // Properly serialize error for logging
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            const errorStack = error instanceof Error ? error.stack : undefined;
+            this.specialistLogger.error('Failed to respond with context', {
+                discussionId,
+                activityId,
+                errorMessage,
+                errorStack
+            });
+            // Re-throw so caller knows it failed
+            throw error;
+        }
+    }
+}
+exports.SpecialistDaemon = SpecialistDaemon;
+//# sourceMappingURL=specialist.js.map

package/dist/agents/shared/specialist.js.map

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

package/dist/agents/shared/tool-schema-loader.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Tool Schema Loader
+ *
+ * Manages MCP tool discovery, schema loading, and filtering.
+ * Shared between all LLM providers (Anthropic, OpenAI, etc.)
+ *
+ * Key Features:
+ * - Load tools with full schemas from MCP server
+ * - Filter tools by groups (READ, WRITE, PLAYGROUND)
+ * - Cache loaded schemas for on-demand access
+ */
+import { ToolGroup } from '../../mcp/tool-registry';
+import { JsonSchema } from './types';
+import Anthropic from '@anthropic-ai/sdk';
+export interface ToolIndexEntry {
+    name: string;
+    description: string;
+    inputSchema: JsonSchema;
+}
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    input_schema: JsonSchema;
+}
+export interface LoadToolsOptions {
+    mcpServerUrl: string;
+    mcpServerApiKey: string;
+    allowedGroups: ToolGroup[];
+    allowedTools?: string[];
+    excludeMessageFetchTools?: boolean;
+}
+export declare class ToolSchemaLoader {
+    private toolSchemaCache;
+    /**
+     * Load tool index with filtering
+     * Returns lightweight tool list with optional exclusions
+     */
+    loadToolIndex(options: LoadToolsOptions): Promise<ToolIndexEntry[]>;
+    /**
+     * Load full schema for a specific tool on-demand
+     */
+    loadToolSchema(mcpServerUrl: string, mcpServerApiKey: string, toolName: string): Promise<any>;
+    /**
+     * Convert tool index to full tool definitions with complete schemas
+     * The MCP server already returns full schemas, so we use them directly
+     */
+    toFullToolDefinitions(toolIndex: ToolIndexEntry[]): Anthropic.Tool[];
+    /**
+     * @deprecated Use toFullToolDefinitions instead - minimal definitions cause LLMs to call tools with empty params
+     */
+    toMinimalToolDefinitions(toolIndex: ToolIndexEntry[]): Anthropic.Tool[];
+    /**
+     * Get count of loaded schemas
+     */
+    getLoadedSchemaCount(): number;
+    /**
+     * Clear schema cache
+     */
+    clearCache(): void;
+    /**
+     * Fetch tool index from MCP server
+     */
+    private fetchMcpToolIndex;
+}
+//# sourceMappingURL=tool-schema-loader.d.ts.map

package/dist/agents/shared/tool-schema-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-schema-loader.d.ts","sourceRoot":"","sources":["../../../src/agents/shared/tool-schema-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEpD,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAsD1C,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,UAAU,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,UAAU,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,SAAS,EAAE,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,wBAAwB,CAAC,EAAE,OAAO,CAAC;CACpC;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,eAAe,CAAiC;IAExD;;;OAGG;IACG,aAAa,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IA8BzE;;OAEG;IACG,cAAc,CAClB,YAAY,EAAE,MAAM,EACpB,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,GAAG,CAAC;IAwEf;;;OAGG;IACH,qBAAqB,CAAC,SAAS,EAAE,cAAc,EAAE,GAAG,SAAS,CAAC,IAAI,EAAE;IAiBpE;;OAEG;IACH,wBAAwB,CAAC,SAAS,EAAE,cAAc,EAAE,GAAG,SAAS,CAAC,IAAI,EAAE;IAIvE;;OAEG;IACH,oBAAoB,IAAI,MAAM;IAI9B;;OAEG;IACH,UAAU,IAAI,IAAI;IAOlB;;OAEG;YACW,iBAAiB;CA2DhC"}