@hailer/mcp 1.1.15 → 1.1.16

package/dist/agents/bug-fixer/specialist.js

@@ -0,0 +1,327 @@
+"use strict";
+/**
+ * Bug Fixer Specialist Daemon
+ *
+ * A specialist daemon for bug fixing that extends SpecialistDaemon.
+ * Bug Fixer handles bug discussions naturally - responds to all messages
+ * in bug discussions (not just @mentions).
+ *
+ * Tools: Uses MCP tools registered in the tool registry.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BugFixerSpecialist = void 0;
+const specialist_1 = require("../shared/specialist");
+const logger_1 = require("../../lib/logger");
+const config_1 = require("../../config");
+class BugFixerSpecialist extends specialist_1.SpecialistDaemon {
+    bugFixerLogger;
+    // Track bug discussions Bug Fixer is handling
+    bugDiscussions = new Map();
+    constructor(config) {
+        super(config);
+        this.bugFixerLogger = (0, logger_1.createLogger)({
+            component: "BugFixerSpecialist",
+            botId: config.botClient.userId,
+        });
+    }
+    /**
+     * Register a bug discussion for Bug Fixer to handle
+     * Call this when a new bug is detected
+     */
+    registerBugDiscussion(discussionId, bugId, bugName, appPath) {
+        this.bugDiscussions.set(discussionId, { bugId, bugName, appPath });
+        this.bugFixerLogger.info("Registered bug discussion", { discussionId, bugId, bugName });
+    }
+    /**
+     * Unregister a bug discussion (bug resolved)
+     */
+    unregisterBugDiscussion(discussionId) {
+        this.bugDiscussions.delete(discussionId);
+    }
+    /**
+     * Check if Bug Fixer is handling a discussion
+     */
+    isHandlingDiscussion(discussionId) {
+        return this.bugDiscussions.has(discussionId);
+    }
+    /**
+     * Override to respond to ALL messages in bug discussions (not just @mentions)
+     */
+    async extractIncomingMessage(signal) {
+        // FIRST: Check if this is a bug discussion we're handling (before @mention check)
+        const discussionId = signal.data?.discussion;
+        this.bugFixerLogger.debug("Checking signal for bug discussion", {
+            discussionId,
+            registeredDiscussions: Array.from(this.bugDiscussions.keys()),
+            signalType: signal.type,
+        });
+        // Check if this is a registered bug discussion
+        const bugInfo = discussionId ? this.bugDiscussions.get(discussionId) : null;
+        if (!bugInfo) {
+            // Not a bug discussion - fall back to @mention check (parent behavior)
+            return super.extractIncomingMessage(signal);
+        }
+        this.bugFixerLogger.info("Processing message in registered bug discussion", {
+            discussionId,
+            bugName: bugInfo.bugName,
+        });
+        // Get the message content
+        const senderId = signal.data?.uid;
+        if (!senderId)
+            return null;
+        // Skip our own messages
+        if (senderId === this.botClient.userId)
+            return null;
+        // Fetch the message content using the Hailer API
+        try {
+            const msgId = signal.data?.msg_id;
+            this.bugFixerLogger.info("Processing bug discussion message", {
+                discussionId,
+                bugName: bugInfo.bugName,
+                msgId,
+            });
+            // Fetch actual message content from API
+            const response = await this.botClient.client.socket.request("v3.discussion.message.latest", [discussionId]);
+            const messages = response?.messages || [];
+            const targetMessage = messages.find((msg) => msg._id === msgId);
+            if (!targetMessage) {
+                this.bugFixerLogger.warn("Message not found in discussion", { discussionId, msgId });
+                return null;
+            }
+            // Extract content - try both field names
+            const messageContent = targetMessage.msg || targetMessage.content || "";
+            if (!messageContent) {
+                this.bugFixerLogger.warn("Message has no content", { discussionId, msgId, targetMessage });
+                return null;
+            }
+            // Get sender name from cache or message
+            const cachedUser = this.botClient.workspaceCache?.usersById[senderId];
+            const senderName = cachedUser?.fullName
+                || `${cachedUser?.firstname || ''} ${cachedUser?.lastname || ''}`.trim()
+                || targetMessage.userName
+                || "User";
+            this.bugFixerLogger.debug("Extracted message content", {
+                discussionId,
+                msgId,
+                contentPreview: messageContent.substring(0, 50),
+                senderName,
+            });
+            // Return a properly structured IncomingMessage with actual content
+            return {
+                id: msgId,
+                discussionId,
+                senderId,
+                senderName,
+                content: messageContent,
+                timestamp: Date.now(),
+                priority: "high",
+                priorityReason: `Bug discussion: ${bugInfo.bugName}`,
+                workspaceId: signal.workspaceId || '',
+                linkedActivityId: bugInfo.bugId,
+                linkedActivityName: bugInfo.bugName,
+                isMention: false,
+                isReplyToBot: false,
+                isDirectMessage: true,
+            };
+        }
+        catch (error) {
+            this.bugFixerLogger.warn("Failed to process bug discussion message", { discussionId, error });
+            return null;
+        }
+    }
+    /**
+     * Bug Fixer's tool whitelist - bug fixing tools
+     */
+    getToolWhitelist() {
+        return [
+            // Standard Hailer tools
+            "list_workflows",
+            "list_workflow_phases",
+            "get_workflow_schema",
+            "list_activities",
+            "show_activity_by_id",
+            "update_activity",
+            "add_discussion_message",
+            "fetch_discussion_messages",
+            "get_activity_from_discussion",
+            "leave_discussion",
+            "search_workspace_users",
+            // Bug Fixer's bug-fixing tools (registered as MCP tools)
+            "bug_fixer_find_app",
+            "bug_fixer_list_files",
+            "bug_fixer_read_file",
+            // "bug_fixer_write_file",  // Disabled - use bug_fixer_apply_fix instead
+            "bug_fixer_apply_fix", // search/replace pattern (token-efficient)
+            "bug_fixer_run_build",
+            "bug_fixer_git_status",
+            "bug_fixer_git_pull",
+            "bug_fixer_git_commit",
+            "bug_fixer_git_push",
+            "bug_fixer_git_revert",
+            "bug_fixer_publish_app",
+        ];
+    }
+    /**
+     * Override system prompt - fully conversational bug fixing
+     */
+    getSystemPrompt() {
+        const basePrompt = super.getSystemPrompt();
+        // Get configured app paths to tell LLM where apps are
+        const appPaths = [];
+        if (config_1.environment.DEV_APPS_PATHS) {
+            appPaths.push(...config_1.environment.DEV_APPS_PATHS.split(',').map(p => p.trim()).filter(p => p));
+        }
+        if (config_1.environment.DEV_APPS_PATH && !appPaths.includes(config_1.environment.DEV_APPS_PATH)) {
+            appPaths.push(config_1.environment.DEV_APPS_PATH);
+        }
+        const appPathsInfo = appPaths.length > 0
+            ? `\n\n<app_directories>\nConfigured app directories: ${appPaths.join(', ')}\nUse bug_fixer_find_app to search these automatically - don't ask users for paths.\n</app_directories>`
+            : '';
+        const conversationalPrompt = `
+
+<critical_rule>
+🚨 **NEVER use update_activity to change bug phase or status!**
+
+Instead, use these dedicated tools:
+- **mark_bug_declined** - when user says "not a bug", "decline", "won't fix"
+- **mark_bug_fixed** - when fix is published AND user confirmed it works
+
+These tools handle phase + status + leaving discussion automatically.
+Using update_activity for phase/status changes is FORBIDDEN.
+</critical_rule>
+
+<identity>
+You're a senior developer helping fix bugs. You have access to the codebase and can read files, make edits, run builds, and publish apps. Use these tools naturally as part of the conversation - like a colleague who happens to have their IDE open.
+</identity>
+
+<personality>
+- Be conversational and friendly, not robotic
+- Explain your thinking in plain language
+- When you use tools, briefly mention what you're doing ("Let me check the code..." / "Looking at the git status...")
+- Don't dump raw tool outputs - summarize what you found
+- If something fails, explain what went wrong and what you'll try next
+- Ask questions when the bug report is unclear
+</personality>
+
+<tools_you_have>
+You have these tools - USE THEM, don't ask users for information you can look up:
+
+**Finding apps:**
+- bug_fixer_find_app({ searchTerm: "app name" }) - searches configured app directories automatically
+  - ALWAYS use this first when you see an app name in the bug report
+  - Don't ask users for paths - the tool finds apps by name
+
+**Reading code:**
+- bug_fixer_list_files({ appPath: "/path/from/find_app" }) - list all source files
+- bug_fixer_read_file({ appPath: "...", filePath: "src/Component.tsx" }) - read file contents
+
+**Making fixes:**
+- bug_fixer_apply_fix with search/replace:
+  \`\`\`json
+  {
+    "appPath": "/full/path/to/app",
+    "fixes": [{
+      "path": "src/Component.tsx",
+      "action": "edit",
+      "search": "exact code to find",
+      "replace": "new code"
+    }]
+  }
+  \`\`\`
+  The search string must EXACTLY match what's in the file.
+
+**Build & Git:**
+- bug_fixer_run_build({ appPath: "..." }) - verify fix compiles
+- bug_fixer_git_status, git_pull, git_commit, git_push, git_revert
+
+**Publishing:**
+- bug_fixer_publish_app({ appPath: "..." }) - deploy to production
+- update_activity - move bug to different phase
+</tools_you_have>
+
+<how_you_work>
+When someone reports a bug:
+1. Understand what's broken - ask if unclear
+2. Find and read the relevant code
+3. Figure out the root cause
+4. Explain what you found and propose a fix
+5. Get their OK before making changes
+6. Apply the fix, make sure it builds
+7. Have them test it
+8. Publish when they confirm it works
+
+But this isn't a rigid checklist - adapt to the conversation. If they say "just fix it", you can be more proactive. If they want to understand the issue first, take time to explain.
+</how_you_work>
+
+<important>
+- Always ask before making code changes (unless they've already said "fix it" or similar)
+- After the fix builds successfully, COMMIT locally but DO NOT PUSH yet
+- Ask user to test the fix first: "The fix builds clean. Can you test it?"
+- Only PUSH after user confirms it works ("looks good", "works", "ship it", etc.)
+- Only PUBLISH to production after explicit user approval
+- If a build fails, read the error and try a different approach - don't give up
+- When done, update the bug phase (use list_workflow_phases to get IDs, then update_activity)
+- You're in a bug discussion - no need for @mentions, just talk naturally
+</important>
+
+<phase_management>
+**Use these tools to close bugs - they handle everything automatically:**
+
+**When declining a bug** (user says "not a bug", "decline", "won't fix"):
+\`\`\`
+mark_bug_declined({
+  bugId: "the-bug-activity-id",
+  workflowId: "the-workflow-id",
+  discussionId: "the-discussion-id",
+  reason: "Not a bug - as designed"
+})
+\`\`\`
+→ Automatically sets phase=Declined, status="Won't Fix", and leaves discussion
+
+**When a fix is complete** (user confirmed fix works, code is published):
+\`\`\`
+mark_bug_fixed({
+  bugId: "the-bug-activity-id",
+  workflowId: "the-workflow-id",
+  discussionId: "the-discussion-id",
+  fixSummary: "Changed X to fix Y"
+})
+\`\`\`
+→ Automatically sets phase=Fixed, status="Fixed", and leaves discussion
+
+**⚠️ IMPORTANT:**
+- Use mark_bug_declined when NO code fix was made
+- Use mark_bug_fixed ONLY after code is published AND user confirmed it works
+- These tools handle phase, status, AND leaving - you don't need to call anything else
+</phase_management>
+
+<example_conversation>
+User: "The pitch should be blue but it's showing green - Lineup Manager app"
+
+You: [immediately use bug_fixer_find_app({ searchTerm: "Lineup Manager" })]
+     "Found the Lineup Manager app. Let me look at the code..."
+     [use bug_fixer_list_files, then bug_fixer_read_file for relevant files]
+
+You: "I found it - the pitch color is set to #4CAF50 (green) in src/components/Pitch.tsx.
+     I can change it to #2196F3 (blue). Want me to make that fix?"
+
+User: "yes"
+
+You: [use bug_fixer_apply_fix, bug_fixer_run_build, bug_fixer_git_commit]
+     "Fixed and committed locally. The pitch is now blue. Can you test it?"
+
+User: "looks good!"
+
+You: [use bug_fixer_git_push]
+     "Pushed to git. Should I publish to production?"
+
+User: "yes"
+
+You: [use bug_fixer_publish_app, update_activity to move to Fixed phase]
+     "Published! Bug marked as fixed. Anything else?"
+</example_conversation>`;
+        return basePrompt + appPathsInfo + conversationalPrompt;
+    }
+}
+exports.BugFixerSpecialist = BugFixerSpecialist;
+//# sourceMappingURL=specialist.js.map

package/dist/agents/bug-fixer/specialist.js.map

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

package/dist/agents/bug-fixer/types.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Bug Reports Module - Type Definitions
+ *
+ * Shared types for the bug monitoring and auto-fix system.
+ * No hardcoded IDs - everything discovered by name patterns.
+ */
+export interface BugReportsConfig {
+    /** Enable/disable the bug monitor */
+    enabled: boolean;
+    /** Workflow name pattern to find Bug Reports workflow */
+    workflowNamePattern: string;
+    /** Phase names for bug lifecycle */
+    phaseNames: {
+        new: string;
+        inProgress: string;
+        fixed: string;
+        closed: string;
+        declined: string;
+    };
+    /** Polling interval in milliseconds */
+    intervalMs: number;
+    /** Enable auto-fix via Bug Fixer bot */
+    autoFix: boolean;
+    /** Post notifications to bug discussions */
+    notifyOnNew: boolean;
+    /** Anthropic API key for Bug Fixer bot (if autoFix enabled) */
+    anthropicApiKey?: string;
+    /** Apps registry - maps appId to project paths */
+    appsRegistry?: Record<string, AppRegistryEntry>;
+}
+export interface AppRegistryEntry {
+    /** Local path to app project */
+    projectPath: string;
+    /** App name for reference */
+    name: string;
+    /** Git remote URL (optional) */
+    gitRemote?: string;
+}
+export interface BugReport {
+    /** Activity ID */
+    id: string;
+    /** Bug title/name */
+    name: string;
+    /** App ID this bug relates to */
+    appId?: string;
+    /** App name */
+    appName?: string;
+    /** Who reported the bug */
+    reportedBy?: string;
+    /** Bug description */
+    description: string;
+    /** Steps to reproduce */
+    stepsToReproduce?: string;
+    /** Expected behavior */
+    expectedBehavior?: string;
+    /** Actual behavior */
+    actualBehavior?: string;
+    /** Priority level */
+    priority?: 'low' | 'medium' | 'high' | 'critical';
+    /** Discussion ID for posting updates */
+    discussionId?: string;
+    /** Workflow ID */
+    workflowId: string;
+    /** Current phase ID */
+    phaseId: string;
+    /** Creation timestamp */
+    createdAt: string;
+    /** Who created the bug activity (user ID) */
+    createdBy?: string;
+    /** Raw field values for custom parsing */
+    rawFields?: Record<string, any>;
+}
+export interface WorkflowDiscoveryResult {
+    /** Found workflow ID */
+    workflowId: string;
+    /** Workflow name */
+    workflowName: string;
+    /** Phase ID mappings */
+    phases: {
+        new?: string;
+        inProgress?: string;
+        fixed?: string;
+        closed?: string;
+        declined?: string;
+    };
+    /** Field ID mappings (discovered by label) */
+    fields: {
+        appId?: string;
+        appName?: string;
+        description?: string;
+        stepsToReproduce?: string;
+        expectedBehavior?: string;
+        actualBehavior?: string;
+        reportedBy?: string;
+        priority?: string;
+    };
+}
+export interface FixResult {
+    success: boolean;
+    /** What was done */
+    summary: string;
+    /** Files modified */
+    filesModified?: string[];
+    /** Commit hash if committed */
+    commitHash?: string;
+    /** New version if published */
+    publishedVersion?: string;
+    /** Error message if failed */
+    error?: string;
+    /** Detailed log of actions */
+    log?: string[];
+}
+export interface BugFixerTaskInput {
+    /** The bug to fix */
+    bug: BugReport;
+    /** App project info */
+    app: AppRegistryEntry;
+    /** Whether to auto-publish after fix */
+    autoPublish: boolean;
+    /** Hailer app ID for publishing */
+    hailerAppId?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/agents/bug-fixer/types.d.ts.map

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

package/dist/agents/bug-fixer/types.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Bug Reports Module - Type Definitions
+ *
+ * Shared types for the bug monitoring and auto-fix system.
+ * No hardcoded IDs - everything discovered by name patterns.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/agents/bug-fixer/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/agents/bug-fixer/types.ts"],"names":[],"mappings":";AAAA;;;;;GAKG"}

package/dist/agents/factory.d.ts

@@ -0,0 +1,172 @@
+/**
+ * Daemon Factory
+ *
+ * Creates and manages agent daemons in orchestrator mode:
+ * - One orchestrator (HAL) handles general conversation
+ * - Specialist daemons handle complex domain-specific tasks
+ *
+ * Uses BotContext for credential management (workspace isolation).
+ */
+import { ChatAgentDaemon } from "./shared/base";
+import { OrchestratorDaemon } from "./hal/daemon";
+import { SpecialistDaemon } from "./shared/specialist";
+import { MultiBotManager } from "./bot-manager";
+import { ConversationState } from "./shared/types";
+import type { WorkspaceSchemaCacheService } from "./shared/services/workspace-schema-cache";
+export interface DaemonManagerOptions {
+    mcpServerUrl: string;
+    anthropicApiKey: string;
+    model?: string;
+    /**
+     * Enable orchestrator mode (default: true)
+     * Set to false only for legacy compatibility
+     */
+    orchestratorMode?: boolean;
+    /**
+     * Email of the bot to use as orchestrator (defaults to first bot)
+     */
+    orchestratorEmail?: string;
+    /**
+     * Map of specialist key to bot email (e.g., { hailerExpert: "expert@bot.com" })
+     */
+    specialistEmails?: Record<string, string>;
+    /**
+     * Map of userId to botType (from workspace config)
+     */
+    botTypeMap?: Map<string, string>;
+    /**
+     * Map of userId to displayName (from Agent Directory activity name)
+     */
+    displayNameMap?: Map<string, string>;
+    /**
+     * Specific workspace ID to use (for webhook-triggered restarts)
+     */
+    workspaceId?: string;
+    /**
+     * 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;
+}
+/**
+ * Manages orchestrator + specialist daemons
+ */
+export declare class DaemonManager {
+    private daemons;
+    private orchestrator;
+    private specialists;
+    private botManager;
+    private options;
+    private botTypeMap;
+    private displayNameMap;
+    constructor(botManager: MultiBotManager, options: DaemonManagerOptions);
+    /**
+     * Get the workspace ID this daemon manager is running for
+     */
+    getWorkspaceId(): string | undefined;
+    /**
+     * Orchestrator mode: one orchestrator (HAL) + specialist daemons
+     */
+    startOrchestratorMode(): Promise<void>;
+    /**
+     * Stop all daemons
+     * Flushes session logs for each daemon before stopping
+     */
+    stopAll(): Promise<void>;
+    /**
+     * Get daemon for a specific bot
+     */
+    getDaemon(botId: string): ChatAgentDaemon | undefined;
+    /**
+     * Get status of all daemons
+     */
+    getStatus(): Array<{
+        botId: string;
+        state: ConversationState;
+    }>;
+    /**
+     * Log current status to console (for monitoring)
+     */
+    logStatus(): void;
+    /**
+     * Get orchestrator instance (only in orchestrator mode)
+     */
+    getOrchestrator(): OrchestratorDaemon | null;
+    /**
+     * Get the workspace schema cache from the orchestrator
+     * Used by other modules that need dynamic workflow/field ID lookup
+     */
+    getSchemaCache(): WorkspaceSchemaCacheService | null;
+    /**
+     * Get specialist by key (only in orchestrator mode)
+     */
+    getSpecialist(key: string): SpecialistDaemon | undefined;
+    /**
+     * Register a standalone daemon (for standalone Bug Fixer mode)
+     */
+    registerStandaloneDaemon(userId: string, daemon: ChatAgentDaemon): void;
+    /**
+     * Check if running in orchestrator mode
+     */
+    isOrchestratorMode(): boolean;
+    /**
+     * Trigger HAL to respond in a discussion with context
+     */
+    triggerHalResponse(discussionId: string, activityId: string, context: string): Promise<void>;
+    /**
+     * Hot-reload: Start a specialist daemon dynamically
+     * Preserves orchestrator conversation context
+     */
+    startSpecialist(email: string, password: string, botType: string, userId?: string): Promise<boolean>;
+    /**
+     * Hot-reload: Stop a specialist daemon dynamically
+     * Preserves orchestrator conversation context
+     */
+    stopSpecialist(botType: string): Promise<boolean>;
+    /**
+     * Hot-reload a specialist (stop if running, start if enabled)
+     */
+    hotReloadSpecialist(email: string, password: string, botType: string, enabled: boolean, userId?: string): Promise<boolean>;
+    /**
+     * Start periodic status logging
+     */
+    startStatusLogging(intervalMs?: number): NodeJS.Timeout;
+}
+export interface CreateDaemonManagerOptions {
+    /** Enable orchestrator mode */
+    orchestratorMode?: boolean;
+    /** Email of orchestrator bot (defaults to first) */
+    orchestratorEmail?: string;
+    /** Map specialist keys to bot emails */
+    specialistEmails?: Record<string, string>;
+    /** Specific workspace ID to use (for webhook-triggered restarts) */
+    workspaceId?: string;
+    /**
+     * Use structured outputs instead of native tools
+     * Saves ~100K tokens per request
+     * Defaults to false, set USE_STRUCTURED_OUTPUTS=true to enable
+     */
+    useStructuredOutputs?: boolean;
+}
+/**
+ * Create and start the daemon manager
+ * This is the main entry point for daemon mode
+ *
+ * Uses WorkspaceContext for credential management (workspace isolation).
+ *
+ * @param options - Optional settings for orchestrator mode
+ */
+export declare function createDaemonManager(options?: CreateDaemonManagerOptions): Promise<DaemonManager | null>;
+/**
+ * Quick start function for testing
+ *
+ * @param orchestratorMode - Enable orchestrator mode (default: true)
+ */
+export declare function startDaemonMode(orchestratorMode?: boolean): Promise<void>;
+/**
+ * Create standalone Bug Fixer daemon (no orchestrator/AI Hub needed)
+ * For testing Bug Fixer independently
+ */
+export declare function createStandaloneBugFixer(email: string, password: string): Promise<DaemonManager | null>;
+//# sourceMappingURL=factory.d.ts.map

package/dist/agents/factory.d.ts.map

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