@hailer/mcp 0.1.15 → 0.1.16

package/dist/agents/giuseppe/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 Giuseppe bot */
+    autoFix: boolean;
+    /** Post notifications to bug discussions */
+    notifyOnNew: boolean;
+    /** Anthropic API key for Giuseppe 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 GiuseppeTaskInput {
+    /** 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/giuseppe/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/hailer-expert/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * HailerExpert Agent
+ *
+ * Uses the shared SpecialistDaemon with config from hal/definitions.ts
+ * No custom daemon class needed - all config is in SPECIALISTS.hailerExpert
+ */
+export { SPECIALISTS } from '../hal/definitions';
+//# sourceMappingURL=index.d.ts.map

package/dist/agents/hailer-expert/index.js

@@ -0,0 +1,14 @@
+"use strict";
+/**
+ * HailerExpert Agent
+ *
+ * Uses the shared SpecialistDaemon with config from hal/definitions.ts
+ * No custom daemon class needed - all config is in SPECIALISTS.hailerExpert
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SPECIALISTS = void 0;
+// Re-export from definitions for convenience
+var definitions_1 = require("../hal/definitions");
+Object.defineProperty(exports, "SPECIALISTS", { enumerable: true, get: function () { return definitions_1.SPECIALISTS; } });
+// HailerExpert uses SpecialistDaemon directly - no custom class
+//# sourceMappingURL=index.js.map

package/dist/agents/hal/daemon.d.ts

@@ -0,0 +1,142 @@
+/**
+ * Orchestrator Daemon (HAL)
+ *
+ * The main conversational bot that handles general chat and coordinates
+ * with specialist bots when tasks are too complex.
+ *
+ * HAL can:
+ * - Handle general conversation and simple queries
+ * - Detect when a task needs specialist help
+ * - Invite specialist bots to the discussion
+ * - Hand off context to specialists
+ * - Summarize specialist responses for users
+ */
+import { ChatAgentDaemon, ChatAgentDaemonConfig, IncomingMessage } from "../shared/base";
+import { HailerSignal } from "../../mcp/signal-handler";
+import { ToolInput } from "../shared/types";
+import Anthropic from "@anthropic-ai/sdk";
+export interface OrchestratorDaemonConfig extends ChatAgentDaemonConfig {
+    /** Map of specialist key to their Hailer user ID */
+    specialistUserIds?: Map<string, string>;
+}
+export declare class OrchestratorDaemon extends ChatAgentDaemon {
+    private orchestratorLogger;
+    private specialists;
+    private activeSpecialistsInDiscussion;
+    private specialistUserIds;
+    private toolsUsedInCurrentMessage;
+    private lastToolsUsed;
+    private lastToolsFailed;
+    private static SILENT_SUCCESS_TOOLS;
+    private lastKnownActivityId;
+    private lastKnownActivityName;
+    private lastKnownActivityTime;
+    private static CONTEXT_MEMORY_TIMEOUT;
+    constructor(config: OrchestratorDaemonConfig);
+    /**
+     * Trigger HAL to respond in a discussion with specific context
+     * Used when bug monitor needs HAL to naturally inform users about Giuseppe being disabled
+     */
+    respondWithContext(discussionId: string, activityId: string, contextMessage: string): Promise<void>;
+    /**
+     * Override agent name for Agent Directory
+     * Uses the actual Hailer user name from BotClient (set in workspace)
+     */
+    protected getAgentName(): {
+        firstName: string;
+        lastName: string;
+    };
+    /**
+     * Override agent description for Agent Directory
+     */
+    protected getAgentDescription(): string;
+    /**
+     * Override Position details for Orchestrator
+     */
+    protected getPositionDetails(): {
+        name: string;
+        purpose: string;
+        personaTone: string;
+        coreCapabilities: string;
+        boundaries: string;
+    };
+    /**
+     * Orchestrator only needs basic tools - complex ops go to specialists
+     */
+    protected getToolWhitelist(): string[];
+    /**
+     * Preprocess tool input - inject context for certain tools
+     * Uses cross-discussion memory to maintain context awareness
+     */
+    protected preprocessToolInput(toolName: string, input: ToolInput): ToolInput;
+    /**
+     * Override to detect tool failures for silent success feature
+     */
+    protected executeToolsAndContinue(toolUseBlocks: Anthropic.ToolUseBlock[], originalMessage: IncomingMessage): Promise<void>;
+    /**
+     * Update cross-discussion memory when processing messages
+     * Call this when entering an activity discussion to remember context
+     */
+    private updateContextMemory;
+    /**
+     * Override to update cross-discussion memory when entering activity discussions
+     */
+    protected extractIncomingMessage(signal: HailerSignal): Promise<IncomingMessage | null>;
+    /**
+     * Register a specialist's Hailer user ID
+     * Called during initialization when we know the specialist bot's user ID
+     */
+    registerSpecialistUserId(specialistKey: string, userId: string, displayName?: string): void;
+    /**
+     * Unregister a specialist (called when specialist is disabled/stopped)
+     * This prevents HAL from trying to invite a disabled specialist
+     */
+    unregisterSpecialist(specialistKey: string): void;
+    /**
+     * Mark a specialist as active in a discussion
+     */
+    private markSpecialistActive;
+    /**
+     * Invite a specialist to a discussion
+     * Always invites first (tool handles membership check), then tags
+     */
+    private inviteSpecialist;
+    /**
+     * Override getTools to include Giuseppe retry tool when there's a pending fix
+     */
+    protected getTools(): Anthropic.Tool[];
+    /**
+     * Get tools list with Giuseppe retry tool added
+     */
+    private getToolsWithGiuseppeRetry;
+    /**
+     * Get pending fix context for a discussion (if any)
+     */
+    private getPendingFixContext;
+    /**
+     * Get pending classification context for a discussion (if any)
+     */
+    private getPendingClassificationContext;
+    /**
+     * Override system prompt to include orchestrator capabilities
+     */
+    protected getSystemPrompt(): string;
+    /**
+     * Override response handling to detect specialist invitations
+     */
+    protected handleLlmResponse(response: Anthropic.Message, originalMessage: IncomingMessage): Promise<void>;
+    /**
+     * Get orchestrator status including specialist info
+     */
+    getOrchestratorStatus(): {
+        conversationState: ReturnType<ChatAgentDaemon["getConversationState"]>;
+        specialists: Array<{
+            key: string;
+            name: string;
+            available: boolean;
+            userId?: string;
+        }>;
+        activeInDiscussions: Record<string, string[]>;
+    };
+}
+//# sourceMappingURL=daemon.d.ts.map