@hailer/mcp 1.1.14 → 1.1.16

package/dist/agents/shared/services/token-billing.js

@@ -0,0 +1,198 @@
+"use strict";
+/**
+ * Token Billing Service
+ *
+ * Handles real-time token burning per workspace with balance checks at session start.
+ *
+ * Workspace Isolation:
+ * - Each workspace has its own token balance (managed by Hailer backend)
+ * - Balance check and burn calls include workspaceId for correct routing
+ *
+ * Behavior:
+ * - Check balance when new session starts -> reject if negative for that workspace
+ * - Burn tokens after each LLM API call -> real-time, charges correct workspace
+ * - Allow balance to go negative during active session -> don't interrupt
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TokenBillingService = void 0;
+// ================================================================================
+// PRICING CONSTANTS
+// ================================================================================
+// Claude Haiku 4.5 pricing (Oct 2025)
+// https://www.anthropic.com/claude/haiku
+const HAIKU_PRICING = {
+    inputPerMillion: 1.00, // $1.00 per 1M input tokens
+    outputPerMillion: 5.00, // $5.00 per 1M output tokens
+    cacheWritePerMillion: 1.25, // $1.25 per 1M cache write tokens (1.25x input)
+    cacheReadPerMillion: 0.10, // $0.10 per 1M cache read tokens (0.1x input)
+};
+// Output-normalized weights (for backend compatibility)
+// Backend expects output-equivalent tokens, not input-equivalent
+const OUTPUT_WEIGHTS = {
+    input: HAIKU_PRICING.inputPerMillion / HAIKU_PRICING.outputPerMillion, // 0.20
+    output: 1.0, // 1.00
+    cacheWrite: HAIKU_PRICING.cacheWritePerMillion / HAIKU_PRICING.outputPerMillion, // 0.25
+    cacheRead: HAIKU_PRICING.cacheReadPerMillion / HAIKU_PRICING.outputPerMillion, // 0.02
+};
+// ================================================================================
+// SERVICE
+// ================================================================================
+class TokenBillingService {
+    logger;
+    hailerClient = null;
+    balanceCache = new Map();
+    static CACHE_TTL_MS = 60_000; // 60 seconds
+    constructor(logger, hailerClient) {
+        this.logger = logger;
+        this.hailerClient = hailerClient || null;
+    }
+    /**
+     * Invalidate cached balance for a workspace
+     * Call this after write operations that cost tokens
+     */
+    invalidateCache(workspaceId) {
+        this.balanceCache.delete(workspaceId);
+        this.logger.debug("Balance cache invalidated", { workspaceId });
+    }
+    /**
+     * Check workspace balance before starting a new session
+     * Returns balance info - caller decides whether to reject
+     *
+     * Error handling: On network failure, returns a default "OK" response
+     * to allow graceful degradation (don't block users due to billing errors)
+     */
+    async checkBalance(workspaceId) {
+        if (!this.hailerClient) {
+            this.logger.warn("Balance check skipped - no Hailer client");
+            // Allow processing when we can't check balance (graceful degradation)
+            return { workspaceId, balance: 999, isNegative: false, hasBalance: true };
+        }
+        // Check cache first
+        const cached = this.balanceCache.get(workspaceId);
+        if (cached && Date.now() - cached.timestamp < TokenBillingService.CACHE_TTL_MS) {
+            const balance = cached.balance;
+            const cacheAge = Math.round((Date.now() - cached.timestamp) / 1000);
+            // Determine status
+            let status;
+            if (balance < 0) {
+                status = '❌ NEGATIVE - SHOULD NOT RESPOND';
+            }
+            else if (balance === 0) {
+                status = '❌ EMPTY - SHOULD NOT RESPOND';
+            }
+            else if (balance < 5) {
+                status = '⚠️ LOW';
+            }
+            else {
+                status = '✅ OK';
+            }
+            this.logger.debug(`💰 BALANCE CHECK (CACHED) | ${workspaceId} | ${balance} tokens | ${status}`);
+            return {
+                workspaceId,
+                balance,
+                isNegative: balance < 0,
+                hasBalance: balance > 0,
+            };
+        }
+        // Cache miss or stale - fetch from backend
+        try {
+            const result = await this.hailerClient.request('v3.mcp.getTokenBalance', [workspaceId]);
+            const balance = typeof result?.balance === "number" ? result.balance :
+                typeof result === "number" ? result : 0;
+            const lastUpdated = result?.lastUpdated ? new Date(result.lastUpdated).toISOString() : 'N/A';
+            // Cache the result
+            this.balanceCache.set(workspaceId, { balance, timestamp: Date.now() });
+            // Determine status
+            let status;
+            if (balance < 0) {
+                status = '❌ NEGATIVE - SHOULD NOT RESPOND';
+            }
+            else if (balance === 0) {
+                status = '❌ EMPTY - SHOULD NOT RESPOND';
+            }
+            else if (balance < 5) {
+                status = '⚠️ LOW';
+            }
+            else {
+                status = '✅ OK';
+            }
+            this.logger.debug(`💰 BALANCE CHECK | ${workspaceId} | ${balance} tokens | ${status}`);
+            return {
+                workspaceId,
+                balance,
+                isNegative: balance < 0,
+                hasBalance: balance > 0,
+            };
+        }
+        catch (error) {
+            this.logger.warn(`❌ BALANCE CHECK FAILED | ${workspaceId} | ${error instanceof Error ? error.message : String(error)}`);
+            return { workspaceId, balance: 0, isNegative: false, hasBalance: false };
+        }
+    }
+    /**
+     * Burn tokens after LLM API call - fire and forget
+     * Does not block the response pipeline
+     *
+     * Error handling: Logs errors but does not throw
+     */
+    async burnTokens(payload) {
+        // Fire and forget - don't await in caller
+        this.burnTokensInternal(payload).catch((error) => {
+            this.logger.error("Token burn failed", {
+                workspaceId: payload.workspaceId,
+                error: error instanceof Error ? error.message : String(error),
+            });
+        });
+    }
+    /**
+     * Internal burn implementation with proper error handling
+     */
+    async burnTokensInternal(payload) {
+        if (!this.hailerClient) {
+            this.logger.warn("Token burn skipped - no Hailer client");
+            return;
+        }
+        // Calculate output-normalized tokens (what backend expects)
+        const normalizedTokens = Math.round(payload.inputTokens * OUTPUT_WEIGHTS.input +
+            payload.outputTokens * OUTPUT_WEIGHTS.output +
+            payload.cacheCreationTokens * OUTPUT_WEIGHTS.cacheWrite +
+            payload.cacheReadTokens * OUTPUT_WEIGHTS.cacheRead);
+        try {
+            const result = await this.hailerClient.request('v3.mcp.deductTokens', [{
+                    mcpToken: 'hL9xK2mNpQrS4tVwY6zA8bCD',
+                    workspaceId: payload.workspaceId,
+                    tokenAmount: normalizedTokens,
+                    model: 'claude-haiku',
+                    meta: {
+                        operation: 'chat'
+                    }
+                }]);
+            // Cache the new balance from response
+            if (result?.newBalance !== undefined) {
+                this.balanceCache.set(payload.workspaceId, {
+                    balance: result.newBalance,
+                    timestamp: Date.now()
+                });
+            }
+            this.logger.debug(`🔥 TOKEN DEDUCTION | ${payload.workspaceId} | ${normalizedTokens} tokens | $${payload.costUsd.toFixed(6)} | balance: ${result?.newBalance ?? 'N/A'}`);
+        }
+        catch (error) {
+            this.logger.warn(`❌ TOKEN DEDUCTION FAILED | ${payload.workspaceId} | ${normalizedTokens} tokens | ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Calculate cost in USD based on token counts
+     * Uses Claude Haiku 4.5 pricing
+     */
+    calculateCost(inputTokens, outputTokens, cacheCreationTokens, cacheReadTokens) {
+        const inputCost = (inputTokens / 1_000_000) * HAIKU_PRICING.inputPerMillion;
+        const outputCost = (outputTokens / 1_000_000) * HAIKU_PRICING.outputPerMillion;
+        const cacheWriteCost = (cacheCreationTokens / 1_000_000) * HAIKU_PRICING.cacheWritePerMillion;
+        const cacheReadCost = (cacheReadTokens / 1_000_000) * HAIKU_PRICING.cacheReadPerMillion;
+        const totalCost = inputCost + outputCost + cacheWriteCost + cacheReadCost;
+        // Round to 8 decimal places to avoid floating point issues
+        return Math.round(totalCost * 100_000_000) / 100_000_000;
+    }
+}
+exports.TokenBillingService = TokenBillingService;
+//# sourceMappingURL=token-billing.js.map

package/dist/agents/shared/services/token-billing.js.map

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

package/dist/agents/shared/services/tool-executor.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Tool Executor Service
+ *
+ * Handles MCP tool execution:
+ * - Executes tool calls from LLM
+ * - Tracks write operations
+ * - Extracts write details for logging
+ */
+import Anthropic from "@anthropic-ai/sdk";
+import { Logger } from "../../../lib/logger";
+import { McpClientService } from "./mcp-client";
+import { TokenBillingService } from "./token-billing";
+import { WriteDetail, ActivitySession, ToolInput, McpToolResult } from "../../shared/types";
+export interface ToolExecutionResult {
+    type: "tool_result";
+    tool_use_id: string;
+    content: string;
+    is_error?: boolean;
+}
+export interface ToolExecutionContext {
+    session?: ActivitySession;
+    preprocessToolInput?: (toolName: string, input: ToolInput) => ToolInput;
+}
+export declare class ToolExecutor {
+    private mcpClient;
+    private logger;
+    private tokenBilling?;
+    private static WRITE_TOOLS;
+    constructor(mcpClient: McpClientService, logger: Logger, tokenBilling?: TokenBillingService | undefined);
+    /**
+     * Check if a tool is a write operation
+     */
+    isWriteTool(toolName: string): boolean;
+    /**
+     * Execute a list of tool calls and return results
+     */
+    executeTools(toolUseBlocks: Anthropic.ToolUseBlock[], context?: ToolExecutionContext): Promise<ToolExecutionResult[]>;
+    /**
+     * Extract details about a write operation for logging
+     */
+    extractWriteDetail(toolName: string, input: ToolInput, result: McpToolResult): WriteDetail | null;
+}
+//# sourceMappingURL=tool-executor.d.ts.map

package/dist/agents/shared/services/tool-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-executor.d.ts","sourceRoot":"","sources":["../../../../src/agents/shared/services/tool-executor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAE5F,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,aAAa,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,mBAAmB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,KAAK,SAAS,CAAC;CACzE;AAED,qBAAa,YAAY;IAsBrB,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,YAAY,CAAC;IAtBvB,OAAO,CAAC,MAAM,CAAC,WAAW,CAiBvB;gBAGO,SAAS,EAAE,gBAAgB,EAC3B,MAAM,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,mBAAmB,YAAA;IAG5C;;OAEG;IACI,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAI7C;;OAEG;IACU,YAAY,CACvB,aAAa,EAAE,SAAS,CAAC,YAAY,EAAE,EACvC,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAkEjC;;OAEG;IACI,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,GAAG,WAAW,GAAG,IAAI;CAmEzG"}

package/dist/agents/shared/services/tool-executor.js

@@ -0,0 +1,175 @@
+"use strict";
+/**
+ * Tool Executor Service
+ *
+ * Handles MCP tool execution:
+ * - Executes tool calls from LLM
+ * - Tracks write operations
+ * - Extracts write details for logging
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ToolExecutor = void 0;
+class ToolExecutor {
+    mcpClient;
+    logger;
+    tokenBilling;
+    // Tools that modify data in Hailer (vs read-only tools)
+    static WRITE_TOOLS = new Set([
+        "create_activity",
+        "update_activity",
+        "add_discussion_message",
+        "invite_discussion_members",
+        "join_discussion",
+        "create_insight",
+        "update_insight",
+        "remove_insight",
+        "create_app",
+        "update_app",
+        "remove_app",
+        "install_workflow",
+        "remove_workflow",
+        "update_workflow_field",
+        "update_workflow_phase",
+        "upload_files",
+    ]);
+    constructor(mcpClient, logger, tokenBilling) {
+        this.mcpClient = mcpClient;
+        this.logger = logger;
+        this.tokenBilling = tokenBilling;
+    }
+    /**
+     * Check if a tool is a write operation
+     */
+    isWriteTool(toolName) {
+        return ToolExecutor.WRITE_TOOLS.has(toolName);
+    }
+    /**
+     * Execute a list of tool calls and return results
+     */
+    async executeTools(toolUseBlocks, context = {}) {
+        const { session, preprocessToolInput } = context;
+        const toolResults = [];
+        for (const toolUse of toolUseBlocks) {
+            this.logger.info("Executing tool", { tool: toolUse.name });
+            // Track tool call in session
+            if (session) {
+                session.metrics.toolCalls++;
+                session.actions.push(`Tool: ${toolUse.name}`);
+                session.lastActivityTime = Date.now();
+            }
+            try {
+                // Load full schema if needed (uses service's cache)
+                await this.mcpClient.loadToolSchemaIfNeeded(toolUse.name);
+                // Allow preprocessing of tool input (cast from Anthropic's unknown type)
+                const rawInput = toolUse.input;
+                const toolInput = preprocessToolInput
+                    ? preprocessToolInput(toolUse.name, rawInput)
+                    : rawInput;
+                const result = await this.mcpClient.callMcpTool(toolUse.name, toolInput);
+                const resultContent = JSON.stringify(result?.content || {});
+                // Track write operations for session logging
+                if (session && this.isWriteTool(toolUse.name)) {
+                    session.metrics.writeOperations++;
+                    const writeDetail = this.extractWriteDetail(toolUse.name, toolInput, result);
+                    if (writeDetail) {
+                        session.writeDetails.push(writeDetail);
+                    }
+                    // Invalidate balance cache after write ops (they cost tokens)
+                    if (this.tokenBilling && session.workspaceId) {
+                        this.tokenBilling.invalidateCache(session.workspaceId);
+                    }
+                }
+                toolResults.push({
+                    type: "tool_result",
+                    tool_use_id: toolUse.id,
+                    content: resultContent,
+                });
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                this.logger.warn("Tool execution failed", {
+                    tool: toolUse.name,
+                    error: errorMessage,
+                });
+                toolResults.push({
+                    type: "tool_result",
+                    tool_use_id: toolUse.id,
+                    content: `Error: ${errorMessage}`,
+                    is_error: true,
+                });
+            }
+        }
+        return toolResults;
+    }
+    /**
+     * Extract details about a write operation for logging
+     */
+    extractWriteDetail(toolName, input, result) {
+        try {
+            const resultText = result?.content?.[0]?.text || "";
+            // Extract activity ID from result if present
+            const idMatch = resultText.match(/"_id":\s*"([a-f0-9]{24})"/i) ||
+                resultText.match(/`([a-f0-9]{24})`/);
+            const targetId = idMatch?.[1] || input.activityId || input.discussionId;
+            switch (toolName) {
+                case "create_activity":
+                    return {
+                        tool: toolName,
+                        what: `Created activity "${input.name || 'unnamed'}"`,
+                        targetId,
+                    };
+                case "update_activity": {
+                    const fieldCount = input.fields ? Object.keys(input.fields).length : 0;
+                    return {
+                        tool: toolName,
+                        what: `Updated ${fieldCount} field(s)${input.name ? ` on "${input.name}"` : ''}`,
+                        targetId: input.activityId,
+                    };
+                }
+                case "add_discussion_message": {
+                    const msgPreview = input.content?.substring(0, 50) || "";
+                    return {
+                        tool: toolName,
+                        what: `Posted message: "${msgPreview}${msgPreview.length >= 50 ? '...' : ''}"`,
+                        targetId: input.discussionId,
+                    };
+                }
+                case "invite_discussion_members":
+                    return {
+                        tool: toolName,
+                        what: `Invited ${input.userIds?.length || 0} member(s) to discussion`,
+                        targetId: input.discussionId,
+                    };
+                case "join_discussion":
+                    return {
+                        tool: toolName,
+                        what: input.inviteUserId ? "Invited user to discussion" : "Joined discussion",
+                        targetId: input.activityId || input.discussionId,
+                    };
+                case "create_insight":
+                    return {
+                        tool: toolName,
+                        what: `Created insight "${input.name || 'unnamed'}"`,
+                        targetId,
+                    };
+                case "update_insight":
+                    return {
+                        tool: toolName,
+                        what: `Updated insight`,
+                        targetId: input.insightId,
+                    };
+                default:
+                    return {
+                        tool: toolName,
+                        what: `Executed ${toolName}`,
+                        targetId,
+                    };
+            }
+        }
+        catch {
+            return null;
+        }
+    }
+}
+exports.ToolExecutor = ToolExecutor;
+//# sourceMappingURL=tool-executor.js.map

package/dist/agents/shared/services/tool-executor.js.map

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

package/dist/agents/shared/services/typing-indicator.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Typing Indicator Service
+ * Manages typing indicator state with auto-refresh for Hailer discussions
+ */
+import { BotClient } from "../../bot-manager";
+import { Logger } from "../../../lib/logger";
+export declare class TypingIndicatorService {
+    private botClient;
+    private logger;
+    private static TYPING_REFRESH_MS;
+    private typingInterval;
+    private typingDiscussionId;
+    constructor(botClient: BotClient, logger: Logger);
+    /**
+     * Start typing indicator with auto-refresh interval
+     */
+    start(discussionId: string): void;
+    /**
+     * Stop typing indicator and clear refresh interval
+     */
+    stop(): void;
+    private sendSignal;
+}
+//# sourceMappingURL=typing-indicator.d.ts.map

package/dist/agents/shared/services/typing-indicator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typing-indicator.d.ts","sourceRoot":"","sources":["../../../../src/agents/shared/services/typing-indicator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAE7C,qBAAa,sBAAsB;IAM/B,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,MAAM;IANhB,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAQ;IACxC,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,kBAAkB,CAAuB;gBAGvC,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,MAAM;IAGxB;;OAEG;IACH,KAAK,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAYjC;;OAEG;IACH,IAAI,IAAI,IAAI;IAWZ,OAAO,CAAC,UAAU;CAQnB"}

package/dist/agents/shared/services/typing-indicator.js

@@ -0,0 +1,54 @@
+"use strict";
+/**
+ * Typing Indicator Service
+ * Manages typing indicator state with auto-refresh for Hailer discussions
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TypingIndicatorService = void 0;
+class TypingIndicatorService {
+    botClient;
+    logger;
+    static TYPING_REFRESH_MS = 3000;
+    typingInterval = null;
+    typingDiscussionId = null;
+    constructor(botClient, logger) {
+        this.botClient = botClient;
+        this.logger = logger;
+    }
+    /**
+     * Start typing indicator with auto-refresh interval
+     */
+    start(discussionId) {
+        this.stop();
+        this.typingDiscussionId = discussionId;
+        this.sendSignal(discussionId, true);
+        this.typingInterval = setInterval(() => {
+            if (this.typingDiscussionId) {
+                this.sendSignal(this.typingDiscussionId, true);
+            }
+        }, TypingIndicatorService.TYPING_REFRESH_MS);
+    }
+    /**
+     * Stop typing indicator and clear refresh interval
+     */
+    stop() {
+        if (this.typingInterval) {
+            clearInterval(this.typingInterval);
+            this.typingInterval = null;
+        }
+        if (this.typingDiscussionId) {
+            this.sendSignal(this.typingDiscussionId, false);
+            this.typingDiscussionId = null;
+        }
+    }
+    sendSignal(discussionId, isTyping) {
+        this.botClient.client.socket.request("messenger.set_discussion_typing_state", [
+            discussionId,
+            isTyping
+        ]).catch((error) => {
+            this.logger.debug("Typing indicator failed", { discussionId, isTyping, error: error?.message });
+        });
+    }
+}
+exports.TypingIndicatorService = TypingIndicatorService;
+//# sourceMappingURL=typing-indicator.js.map

package/dist/agents/shared/services/typing-indicator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typing-indicator.js","sourceRoot":"","sources":["../../../../src/agents/shared/services/typing-indicator.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAKH,MAAa,sBAAsB;IAMvB;IACA;IANF,MAAM,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAChC,cAAc,GAA0B,IAAI,CAAC;IAC7C,kBAAkB,GAAkB,IAAI,CAAC;IAEjD,YACU,SAAoB,EACpB,MAAc;QADd,cAAS,GAAT,SAAS,CAAW;QACpB,WAAM,GAAN,MAAM,CAAQ;IACrB,CAAC;IAEJ;;OAEG;IACH,KAAK,CAAC,YAAoB;QACxB,IAAI,CAAC,IAAI,EAAE,CAAC;QACZ,IAAI,CAAC,kBAAkB,GAAG,YAAY,CAAC;QACvC,IAAI,CAAC,UAAU,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;QAEpC,IAAI,CAAC,cAAc,GAAG,WAAW,CAAC,GAAG,EAAE;YACrC,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;gBAC5B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,kBAAkB,EAAE,IAAI,CAAC,CAAC;YACjD,CAAC;QACH,CAAC,EAAE,sBAAsB,CAAC,iBAAiB,CAAC,CAAC;IAC/C,CAAC;IAED;;OAEG;IACH,IAAI;QACF,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,aAAa,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YACnC,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;QAC7B,CAAC;QACD,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC5B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,kBAAkB,EAAE,KAAK,CAAC,CAAC;YAChD,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC;QACjC,CAAC;IACH,CAAC;IAEO,UAAU,CAAC,YAAoB,EAAE,QAAiB;QACxD,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,uCAAuC,EAAE;YAC5E,YAAY;YACZ,QAAQ;SACT,CAAC,CAAC,KAAK,CAAC,CAAC,KAAU,EAAE,EAAE;YACtB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,yBAAyB,EAAE,EAAE,YAAY,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;QAClG,CAAC,CAAC,CAAC;IACL,CAAC;;AA9CH,wDA+CC"}

package/dist/agents/shared/services/workspace-schema-cache.d.ts

@@ -0,0 +1,122 @@
+/**
+ * Workspace Schema Cache Service
+ *
+ * Dynamically discovers and caches workflow schemas per workspace.
+ * Replaces hardcoded workflow/field IDs with runtime lookup.
+ *
+ * WORKSPACE ISOLATION: Each workspace gets its own workflow IDs.
+ * Never use hardcoded IDs - always lookup via this cache.
+ *
+ * On bot startup:
+ * 1. Check memory cache first
+ * 2. If cache miss: Query list_workflows to find AI Agent workflows by name
+ * 3. If missing, install them from marketplace
+ * 4. Query get_workflow_schema to get field IDs
+ * 5. Store in memory cache for session duration
+ */
+import { Logger } from "../../../lib/logger";
+import { McpToolCallback } from "../../shared/types";
+/** Cached workflow schema */
+export interface WorkflowSchema {
+    workflowId: string;
+    name: string;
+    phases: Record<string, string>;
+    fields: Record<string, string>;
+}
+/** Per-workspace cache */
+export interface WorkspaceSchemas {
+    workspaceId: string;
+    sessionLog?: WorkflowSchema;
+    agentDirectory?: WorkflowSchema;
+    positions?: WorkflowSchema;
+    teams?: WorkflowSchema;
+    toolRegistry?: WorkflowSchema;
+    mcpConfig?: WorkflowSchema;
+    initialized: boolean;
+}
+export declare class WorkspaceSchemaCacheService {
+    private logger;
+    private callMcpTool;
+    private cache;
+    constructor(logger: Logger, callMcpTool: McpToolCallback);
+    /**
+     * Initialize schema cache for a workspace
+     * Call this on bot startup after connecting to Hailer
+     *
+     * Set SKIP_SCHEMA_DISCOVERY=true to skip API calls on startup.
+     * HAL can discover workflows on-demand via MCP tools when needed.
+     */
+    initializeForWorkspace(workspaceId: string): Promise<WorkspaceSchemas>;
+    /**
+     * Get cached schemas for a workspace
+     */
+    getSchemas(workspaceId: string): WorkspaceSchemas | undefined;
+    /**
+     * Get Session Log schema for a workspace
+     */
+    getSessionLogSchema(workspaceId: string): WorkflowSchema | undefined;
+    /**
+     * Get Agent Directory schema for a workspace
+     */
+    getAgentDirectorySchema(workspaceId: string): WorkflowSchema | undefined;
+    /**
+     * Get Positions schema for a workspace
+     */
+    getPositionsSchema(workspaceId: string): WorkflowSchema | undefined;
+    /**
+     * Get Teams schema for a workspace
+     */
+    getTeamsSchema(workspaceId: string): WorkflowSchema | undefined;
+    /**
+     * Get Tool Registry schema for a workspace
+     */
+    getToolRegistrySchema(workspaceId: string): WorkflowSchema | undefined;
+    /**
+     * Get MCP Config schema for a workspace
+     */
+    getMcpConfigSchema(workspaceId: string): WorkflowSchema | undefined;
+    /**
+     * Check if a workspace has the AI Agent template installed
+     */
+    hasAgentTemplate(workspaceId: string): boolean;
+    /**
+     * Check if workflow name matches a pattern (case insensitive, ignores emojis)
+     */
+    private matchesPattern;
+    /**
+     * Map workflow list to schema slots (using pattern matching)
+     */
+    private mapWorkflowsToSchemas;
+    /**
+     * Load detailed schemas (phases, fields) for all found workflows
+     */
+    private loadDetailedSchemas;
+    /**
+     * Install AI Agent template from marketplace
+     */
+    private installAgentTemplate;
+    /**
+     * Parse workflows from list_workflows response
+     * Handles both raw JSON and markdown-wrapped JSON responses
+     */
+    private parseWorkflows;
+    /**
+     * Load detailed workflow schema (phases and fields) for an existing schema
+     */
+    private loadWorkflowSchemaDetails;
+    /**
+     * Parse phases from list_workflow_phases response
+     * Format: 1. **PhaseName**\n   - Phase ID: `phaseId`
+     */
+    private parsePhases;
+    /**
+     * Parse fields from get_workflow_schema response
+     * Stores fields by both label and key for flexible lookup
+     */
+    private parseFields;
+    /**
+     * Clear cache for a workspace (memory cache only)
+     */
+    clearCache(workspaceId?: string): void;
+}
+//# sourceMappingURL=workspace-schema-cache.d.ts.map

package/dist/agents/shared/services/workspace-schema-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-schema-cache.d.ts","sourceRoot":"","sources":["../../../../src/agents/shared/services/workspace-schema-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAgBrD,6BAA6B;AAC7B,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED,0BAA0B;AAC1B,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,YAAY,CAAC,EAAE,cAAc,CAAC;IAC9B,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,qBAAa,2BAA2B;IAIpC,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,WAAW;IAJrB,OAAO,CAAC,KAAK,CAA4C;gBAG/C,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,eAAe;IAGtC;;;;;;OAMG;IACU,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA+FnF;;OAEG;IACI,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAIpE;;OAEG;IACI,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAI3E;;OAEG;IACI,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAI/E;;OAEG;IACI,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAI1E;;OAEG;IACI,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAItE;;OAEG;IACI,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAI7E;;OAEG;IACI,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAI1E;;OAEG;IACI,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAKrD;;OAEG;IACH,OAAO,CAAC,cAAc;IAWtB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA6B7B;;OAEG;YACW,mBAAmB;IASjC;;OAEG;YACW,oBAAoB;IAmElC;;;OAGG;IACH,OAAO,CAAC,cAAc;IAoDtB;;OAEG;YACW,yBAAyB;IAwDvC;;;OAGG;IACH,OAAO,CAAC,WAAW;IAoCnB;;;OAGG;IACH,OAAO,CAAC,WAAW;IA0DnB;;OAEG;IACI,UAAU,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI;CAS9C"}