@rk0429/agentic-relay 21.3.0 → 22.1.0

package/dist/application/chat/chat-inbound-handler.js

@@ -0,0 +1,193 @@
+import { emitChatLog } from "./chat-logging.js";
+import { MessageRouter } from "../../domain/chat/message-router.js";
+import { SessionBridge, ThreadKey } from "../../domain/chat/session-bridge.js";
+export class ChatInboundHandler {
+    deps;
+    activeOperations = 0;
+    idleWaiters = new Set();
+    sessionTimeoutMinutes;
+    maxMessageLength;
+    logger;
+    constructor(deps) {
+        this.deps = deps;
+        this.sessionTimeoutMinutes = deps.sessionTimeoutMinutes ?? 30;
+        this.maxMessageLength = deps.maxMessageLength ?? 10_000;
+        this.logger = deps.logger;
+    }
+    configure(options) {
+        if (options.sessionTimeoutMinutes !== undefined) {
+            this.sessionTimeoutMinutes = Math.max(1, Math.floor(options.sessionTimeoutMinutes));
+        }
+        if (options.maxMessageLength !== undefined) {
+            this.maxMessageLength = Math.max(1, Math.floor(options.maxMessageLength));
+        }
+        if (options.messageQueueMaxSize !== undefined) {
+            this.deps.messageQueueManager.setMaxBufferedPerThread(options.messageQueueMaxSize);
+        }
+        if (options.logger !== undefined) {
+            this.logger = options.logger;
+        }
+    }
+    async handleInbound(event) {
+        const startTime = Date.now();
+        const durationMs = () => Date.now() - startTime;
+        const incomingKey = new ThreadKey({
+            platform: event.platform,
+            teamOrGuildId: event.teamOrGuildId,
+            channelId: event.channelId,
+            threadId: event.threadId,
+        });
+        const queueKey = incomingKey.toString();
+        await this.log("info", "chat inbound received", {
+            platform: event.platform,
+            threadKey: queueKey,
+            teamOrGuildId: event.teamOrGuildId,
+            channelId: event.channelId,
+            threadId: event.threadId,
+            messageId: event.messageId,
+            userId: event.userId,
+            isDM: event.isDM,
+            isMention: event.isMention,
+        });
+        if (this.deps.messageQueueManager.isProcessing(queueKey)) {
+            this.deps.messageQueueManager.enqueue(queueKey, event);
+            await this.log("warn", "chat inbound buffered", {
+                platform: event.platform,
+                threadKey: queueKey,
+                messageId: event.messageId,
+                durationMs: durationMs(),
+            });
+            return;
+        }
+        const intent = MessageRouter.determineIntent(event, (key) => this.deps.sessionBridgeRepository.findByThreadKey(key), (key) => this.deps.questionService.findPendingByThreadKey(key), this.sessionTimeoutMinutes, this.maxMessageLength);
+        if (intent.kind === "ignored") {
+            await this.log("info", "chat inbound ignored", {
+                platform: event.platform,
+                reason: intent.reason,
+                threadKey: queueKey,
+                intent: intent.kind,
+                durationMs: durationMs(),
+            });
+            return;
+        }
+        this.activeOperations += 1;
+        this.deps.messageQueueManager.startProcessing(queueKey);
+        const stopIndicator = await this.deps.outboundHandler.beginProcessingIndicator(event);
+        try {
+            if (intent.kind === "answer_question") {
+                await this.deps.questionService.handlePotentialAnswer(event);
+                await this.log("info", "chat answer processed", {
+                    platform: event.platform,
+                    threadKey: queueKey,
+                    intent: intent.kind,
+                    durationMs: durationMs(),
+                });
+                return;
+            }
+            if (intent.kind === "new_session") {
+                await this.handleNewSession(event, intent, durationMs);
+                return;
+            }
+            await this.handleContinuation(event, intent, durationMs);
+        }
+        finally {
+            await stopIndicator?.();
+            this.deps.messageQueueManager.finishProcessing(queueKey);
+            this.activeOperations = Math.max(0, this.activeOperations - 1);
+            if (this.activeOperations === 0) {
+                for (const resolve of this.idleWaiters) {
+                    resolve();
+                }
+                this.idleWaiters.clear();
+            }
+            for (const buffered of this.deps.messageQueueManager.dequeueAll(queueKey)) {
+                await this.handleInbound(buffered);
+            }
+        }
+    }
+    async waitForIdle(timeoutMs) {
+        if (this.activeOperations === 0) {
+            return;
+        }
+        await Promise.race([
+            new Promise((resolve) => this.idleWaiters.add(resolve)),
+            new Promise((resolve) => setTimeout(resolve, timeoutMs)),
+        ]);
+    }
+    async handleNewSession(event, intent, durationMs) {
+        let responseTarget = {
+            channelId: event.channelId,
+            threadId: event.threadId,
+            userId: event.isDM ? event.userId : undefined,
+            messageId: event.messageId,
+        };
+        if (intent.invalidBackendWarning) {
+            const warningResult = await this.deps.outboundHandler.sendResponse(event.platform, responseTarget, `⚠️ Unknown backend "${intent.invalidBackendWarning}". Using default routing.`);
+            responseTarget = {
+                ...responseTarget,
+                channelId: warningResult.channelId ?? responseTarget.channelId,
+                threadId: warningResult.threadId ?? responseTarget.threadId,
+                messageId: warningResult.threadId ?? responseTarget.threadId
+                    ? undefined
+                    : responseTarget.messageId,
+            };
+        }
+        const result = await this.deps.agentGateway.startSession(intent.cleanedText, intent.backendSpec);
+        const sendResult = await this.deps.outboundHandler.sendResponse(event.platform, responseTarget, result.response);
+        const bridge = SessionBridge.create(new ThreadKey({
+            platform: event.platform,
+            teamOrGuildId: sendResult.teamOrGuildId ?? event.teamOrGuildId,
+            channelId: sendResult.channelId ?? event.channelId,
+            threadId: sendResult.threadId ?? event.threadId,
+        }), result.relaySessionId, result.backend);
+        bridge.backendSessionId = result.backendSessionId ?? bridge.backendSessionId;
+        this.deps.sessionBridgeRepository.save(bridge);
+        await this.log("info", "chat session started", {
+            platform: event.platform,
+            relaySessionId: result.relaySessionId,
+            backend: result.backend,
+            threadKey: bridge.threadKey.toString(),
+            intent: intent.kind,
+            durationMs: durationMs(),
+        });
+    }
+    async handleContinuation(event, intent, durationMs) {
+        intent.bridge.startProcessing();
+        this.deps.sessionBridgeRepository.save(intent.bridge);
+        const result = await this.deps.agentGateway.continueSession(intent.bridge.relaySessionId, intent.cleanedText);
+        const sendResult = await this.deps.outboundHandler.sendResponse(event.platform, {
+            channelId: intent.bridge.threadKey.channelId,
+            threadId: intent.bridge.threadKey.threadId,
+            userId: event.isDM ? event.userId : undefined,
+            messageId: event.messageId,
+        }, result.response);
+        const updatedBridge = new SessionBridge({
+            threadKey: new ThreadKey({
+                platform: event.platform,
+                teamOrGuildId: sendResult.teamOrGuildId ?? intent.bridge.threadKey.teamOrGuildId,
+                channelId: sendResult.channelId ?? intent.bridge.threadKey.channelId,
+                threadId: sendResult.threadId ?? intent.bridge.threadKey.threadId,
+            }),
+            relaySessionId: result.relaySessionId,
+            backendSessionId: result.backendSessionId ?? intent.bridge.backendSessionId,
+            backend: result.backend,
+            createdAt: intent.bridge.createdAt,
+            lastActivityAt: new Date(),
+            isProcessing: false,
+        });
+        updatedBridge.finishProcessing();
+        this.deps.sessionBridgeRepository.save(updatedBridge);
+        await this.log("info", "chat session continued", {
+            platform: event.platform,
+            relaySessionId: result.relaySessionId,
+            backend: result.backend,
+            threadKey: updatedBridge.threadKey.toString(),
+            intent: intent.kind,
+            durationMs: durationMs(),
+        });
+    }
+    async log(level, message, metadata) {
+        await emitChatLog(this.logger, level, message, metadata);
+    }
+}
+//# sourceMappingURL=chat-inbound-handler.js.map

package/dist/application/chat/chat-inbound-handler.js.map

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

package/dist/application/chat/chat-logging.d.ts

@@ -0,0 +1,8 @@
+export interface ChatStructuredLogger {
+    info(message: string, metadata?: Record<string, unknown>): Promise<void> | void;
+    warn(message: string, metadata?: Record<string, unknown>): Promise<void> | void;
+    error(message: string, metadata?: Record<string, unknown>): Promise<void> | void;
+}
+export type ChatLoggerLike = ChatStructuredLogger | ((message: string, metadata?: Record<string, unknown>) => Promise<void> | void);
+export declare const noopChatLogger: ChatStructuredLogger;
+export declare function emitChatLog(logger: ChatLoggerLike | undefined, level: keyof ChatStructuredLogger, message: string, metadata?: Record<string, unknown>): Promise<void>;

package/dist/application/chat/chat-logging.js

@@ -0,0 +1,16 @@
+export const noopChatLogger = {
+    info() { },
+    warn() { },
+    error() { },
+};
+export async function emitChatLog(logger, level, message, metadata) {
+    if (!logger) {
+        return;
+    }
+    if (typeof logger === "function") {
+        await Promise.resolve(logger(message, metadata));
+        return;
+    }
+    await Promise.resolve(logger[level](message, metadata));
+}
+//# sourceMappingURL=chat-logging.js.map

package/dist/application/chat/chat-logging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-logging.js","sourceRoot":"","sources":["../../../src/application/chat/chat-logging.ts"],"names":[],"mappings":"AAUA,MAAM,CAAC,MAAM,cAAc,GAAyB;IAClD,IAAI,KAAU,CAAC;IACf,IAAI,KAAU,CAAC;IACf,KAAK,KAAU,CAAC;CACjB,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,MAAkC,EAClC,KAAiC,EACjC,OAAe,EACf,QAAkC;IAElC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO;IACT,CAAC;IAED,IAAI,OAAO,MAAM,KAAK,UAAU,EAAE,CAAC;QACjC,MAAM,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;QACjD,OAAO;IACT,CAAC;IAED,MAAM,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;AAC1D,CAAC"}

package/dist/application/chat/chat-outbound-handler.d.ts

@@ -0,0 +1,17 @@
+import { PlatformType, type ChatChannel } from "../../domain/chat/platform-types.js";
+import type { ChatPlatformAdapter } from "../../domain/chat/ports.js";
+import type { ChatTarget, InboundChatEvent, SendResult } from "../../domain/chat/types.js";
+export declare class ChatOutboundHandler {
+    private adaptersByPlatform;
+    constructor(adapters?: ChatPlatformAdapter[]);
+    setAdapters(adapters: ChatPlatformAdapter[]): void;
+    sendResponse(platform: PlatformType | undefined, target: Omit<ChatTarget, "platform">, content: string): Promise<SendResult>;
+    listChannels(platform?: PlatformType): Promise<ChatChannel[]>;
+    beginProcessingIndicator(event: InboundChatEvent): Promise<(() => Promise<void>) | undefined>;
+    static markdownToSlackMrkdwn(markdown: string): string;
+    static markdownToSlackBlocks(markdown: string): Array<Record<string, unknown>>;
+    static markdownToDiscordEmbed(markdown: string): Record<string, unknown> | null;
+    private resolveAdapter;
+    private resolveChannelName;
+    private buildMessage;
+}

package/dist/application/chat/chat-outbound-handler.js

@@ -0,0 +1,207 @@
+import { ValidationError } from "../../core/types.js";
+import { PlatformType } from "../../domain/chat/platform-types.js";
+import { MessageSplitter } from "../../domain/chat/message-splitter.js";
+export class ChatOutboundHandler {
+    adaptersByPlatform;
+    constructor(adapters = []) {
+        this.adaptersByPlatform = new Map();
+        this.setAdapters(adapters);
+    }
+    setAdapters(adapters) {
+        this.adaptersByPlatform = new Map(adapters.map((adapter) => [adapter.platform, adapter]));
+    }
+    async sendResponse(platform, target, content) {
+        const adapter = this.resolveAdapter(platform);
+        const resolvedTarget = await this.resolveChannelName(adapter, target);
+        const maxLength = adapter.platform === PlatformType.Slack ? 4_000 : 2_000;
+        const pieces = MessageSplitter.split(content, maxLength);
+        const baseTarget = {
+            platform: adapter.platform,
+            ...resolvedTarget,
+        };
+        let replyTarget = baseTarget;
+        let firstResult;
+        for (const piece of pieces) {
+            const message = this.buildMessage(adapter.platform, piece);
+            const result = await adapter.sendMessage(replyTarget, message);
+            firstResult ??= result;
+            if (!replyTarget.threadId && result.threadId) {
+                replyTarget = {
+                    ...replyTarget,
+                    channelId: result.channelId ?? replyTarget.channelId,
+                    threadId: result.threadId,
+                    messageId: undefined,
+                };
+            }
+        }
+        return firstResult ?? {
+            success: true,
+            messageId: "",
+            channelId: resolvedTarget.channelId,
+            threadId: resolvedTarget.threadId,
+        };
+    }
+    async listChannels(platform) {
+        const adapter = this.resolveAdapter(platform);
+        return adapter.getChannels();
+    }
+    async beginProcessingIndicator(event) {
+        const adapter = this.adaptersByPlatform.get(event.platform);
+        const stopIndicator = await adapter?.beginProcessingIndicator?.(event);
+        return typeof stopIndicator === "function" ? stopIndicator : undefined;
+    }
+    static markdownToSlackMrkdwn(markdown) {
+        return markdown
+            .replace(/\r\n/g, "\n")
+            .replace(/^#\s+(.+)$/gm, (_, title) => `*${title.trim()}*`)
+            .replace(/\*\*(.+?)\*\*/g, "*$1*");
+    }
+    static markdownToSlackBlocks(markdown) {
+        const blocks = [];
+        const segments = splitMarkdownSegments(markdown);
+        for (const segment of segments) {
+            const trimmed = segment.trim();
+            if (!trimmed) {
+                continue;
+            }
+            const headingMatch = trimmed.match(/^#\s+(.+)$/);
+            if (headingMatch) {
+                blocks.push({
+                    type: "header",
+                    text: {
+                        type: "plain_text",
+                        text: headingMatch[1].trim().slice(0, 150),
+                    },
+                });
+                continue;
+            }
+            blocks.push({
+                type: "section",
+                text: {
+                    type: "mrkdwn",
+                    text: ChatOutboundHandler.markdownToSlackMrkdwn(trimmed).slice(0, 3_000),
+                },
+            });
+        }
+        return blocks;
+    }
+    static markdownToDiscordEmbed(markdown) {
+        const normalized = markdown.trim();
+        const headingMatch = normalized.match(/^#\s+(.+?)(?:\n+([\s\S]*))?$/);
+        if (!headingMatch && normalized.length < 500) {
+            return null;
+        }
+        const title = headingMatch?.[1]?.trim();
+        const description = (headingMatch?.[2] ?? normalized).trim();
+        return {
+            title: title || undefined,
+            description: description || normalized,
+        };
+    }
+    resolveAdapter(platform) {
+        if (platform) {
+            const adapter = this.adaptersByPlatform.get(platform);
+            if (!adapter) {
+                throw new ValidationError(`Platform "${platform}" is not connected.`, {
+                    recoveryHint: "Start the chat daemon with credentials for the requested platform.",
+                });
+            }
+            return adapter;
+        }
+        const adapters = [...this.adaptersByPlatform.values()];
+        if (adapters.length === 1) {
+            return adapters[0];
+        }
+        throw new ValidationError("platform is required when multiple chat platforms are connected.", {
+            recoveryHint: "Specify platform: slack or discord.",
+        });
+    }
+    async resolveChannelName(adapter, target) {
+        if (!target.channelId?.startsWith("#")) {
+            return target;
+        }
+        const name = target.channelId.slice(1);
+        const found = (await adapter.getChannels()).find((channel) => channel.name === name);
+        if (!found) {
+            throw new ValidationError(`Channel "${target.channelId}" not found.`, {
+                recoveryHint: "Use chat_list_channels to find available channel names and IDs.",
+            });
+        }
+        return {
+            ...target,
+            channelId: found.id,
+        };
+    }
+    buildMessage(platform, content) {
+        if (platform === PlatformType.Slack) {
+            try {
+                return {
+                    content: ChatOutboundHandler.markdownToSlackMrkdwn(content),
+                    format: "plain_text",
+                    metadata: {
+                        blocks: ChatOutboundHandler.markdownToSlackBlocks(content),
+                        plainText: content,
+                    },
+                };
+            }
+            catch {
+                return {
+                    content: ChatOutboundHandler.markdownToSlackMrkdwn(content),
+                    format: "plain_text",
+                };
+            }
+        }
+        try {
+            const embed = ChatOutboundHandler.markdownToDiscordEmbed(content);
+            if (embed) {
+                return {
+                    content,
+                    format: "markdown",
+                    metadata: {
+                        embed,
+                        plainText: content,
+                    },
+                };
+            }
+        }
+        catch {
+            // Fall back to plain markdown below.
+        }
+        return {
+            content,
+            format: "markdown",
+        };
+    }
+}
+function splitMarkdownSegments(markdown) {
+    const lines = markdown.replace(/\r\n/g, "\n").split("\n");
+    const segments = [];
+    const buffer = [];
+    let inCodeBlock = false;
+    const flush = () => {
+        if (buffer.length === 0) {
+            return;
+        }
+        segments.push(buffer.join("\n"));
+        buffer.length = 0;
+    };
+    for (const line of lines) {
+        const trimmed = line.trimStart();
+        if (trimmed.startsWith("```")) {
+            inCodeBlock = !inCodeBlock;
+            buffer.push(line);
+            if (!inCodeBlock) {
+                flush();
+            }
+            continue;
+        }
+        if (!inCodeBlock && line.trim() === "") {
+            flush();
+            continue;
+        }
+        buffer.push(line);
+    }
+    flush();
+    return segments;
+}
+//# sourceMappingURL=chat-outbound-handler.js.map

package/dist/application/chat/chat-outbound-handler.js.map

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

package/dist/application/chat/chat-question-service.d.ts

@@ -0,0 +1,37 @@
+import type { PlatformType } from "../../domain/chat/platform-types.js";
+import type { ChatPlatformAdapter, UserQuestionRepository } from "../../domain/chat/ports.js";
+import { ThreadKey } from "../../domain/chat/session-bridge.js";
+import { UserQuestion } from "../../domain/chat/user-question.js";
+import type { InboundChatEvent } from "../../domain/chat/types.js";
+export interface AskUserResult {
+    answered: boolean;
+    response?: string;
+    user_id?: string;
+    timestamp?: string;
+    reason?: "timeout";
+}
+export declare class InMemoryUserQuestionRepository implements UserQuestionRepository {
+    private readonly questions;
+    findPendingByThreadKey(key: ThreadKey): UserQuestion | null;
+    save(question: UserQuestion): void;
+}
+export declare class ChatQuestionService {
+    private readonly deps;
+    private adaptersByPlatform;
+    private readonly pendingQuestions;
+    private maxMessageLength;
+    constructor(deps: {
+        userQuestionRepository: UserQuestionRepository;
+        adapters?: ChatPlatformAdapter[];
+        now?: () => Date;
+        questionIdFactory?: () => string;
+    });
+    setAdapters(adapters: ChatPlatformAdapter[]): void;
+    configure(options: {
+        maxMessageLength?: number;
+    }): void;
+    findPendingByThreadKey(key: ThreadKey): UserQuestion | null;
+    ask(userId: string, questionText: string, timeoutSeconds?: number, platform?: PlatformType, channel?: string): Promise<AskUserResult>;
+    handlePotentialAnswer(event: InboundChatEvent): Promise<boolean>;
+    private resolveAdapter;
+}

package/dist/application/chat/chat-question-service.js

@@ -0,0 +1,135 @@
+import { randomUUID } from "node:crypto";
+import { ValidationError } from "../../core/types.js";
+import { MessageCleaner } from "../../domain/chat/message-cleaner.js";
+import { ThreadKey } from "../../domain/chat/session-bridge.js";
+import { QuestionState, UserQuestion, } from "../../domain/chat/user-question.js";
+export class InMemoryUserQuestionRepository {
+    questions = new Map();
+    findPendingByThreadKey(key) {
+        for (const question of this.questions.values()) {
+            if (question.state === QuestionState.Pending &&
+                question.replyScope?.equals(key)) {
+                return question;
+            }
+        }
+        return null;
+    }
+    save(question) {
+        this.questions.set(question.questionId, question);
+    }
+}
+export class ChatQuestionService {
+    deps;
+    adaptersByPlatform;
+    pendingQuestions = new Map();
+    maxMessageLength;
+    constructor(deps) {
+        this.deps = deps;
+        this.adaptersByPlatform = new Map();
+        this.maxMessageLength = 10_000;
+        this.setAdapters(deps.adapters ?? []);
+    }
+    setAdapters(adapters) {
+        this.adaptersByPlatform = new Map(adapters.map((adapter) => [adapter.platform, adapter]));
+    }
+    configure(options) {
+        if (options.maxMessageLength !== undefined) {
+            this.maxMessageLength = Math.max(1, Math.floor(options.maxMessageLength));
+        }
+    }
+    findPendingByThreadKey(key) {
+        return this.deps.userQuestionRepository.findPendingByThreadKey(key);
+    }
+    async ask(userId, questionText, timeoutSeconds = 300, platform, channel) {
+        const adapter = this.resolveAdapter(platform);
+        const normalizedTimeout = Math.max(1, Math.floor(timeoutSeconds));
+        const question = UserQuestion.ask(this.deps.questionIdFactory?.() ?? randomUUID(), userId, questionText, normalizedTimeout);
+        this.deps.userQuestionRepository.save(question);
+        const sendResult = await adapter.sendMessage({
+            platform: adapter.platform,
+            userId,
+            channelId: channel,
+        }, {
+            content: questionText,
+            format: "markdown",
+        });
+        const replyChannelId = sendResult.channelId ?? channel;
+        if (!replyChannelId) {
+            throw new ValidationError("Unable to determine reply channel for chat_ask_user.", {
+                recoveryHint: "Ensure the chat adapter returns channelId for sent messages or pass channel explicitly.",
+            });
+        }
+        question.markSent(new ThreadKey({
+            platform: adapter.platform,
+            teamOrGuildId: sendResult.teamOrGuildId,
+            channelId: replyChannelId,
+            threadId: sendResult.threadId,
+        }));
+        this.deps.userQuestionRepository.save(question);
+        return new Promise((resolve) => {
+            const timer = setTimeout(() => {
+                if (question.state === QuestionState.Pending) {
+                    question.markTimedOut();
+                    this.deps.userQuestionRepository.save(question);
+                }
+                this.pendingQuestions.delete(question.questionId);
+                resolve({
+                    answered: false,
+                    reason: "timeout",
+                });
+            }, normalizedTimeout * 1_000);
+            this.pendingQuestions.set(question.questionId, {
+                question,
+                resolve,
+                timer,
+            });
+        });
+    }
+    async handlePotentialAnswer(event) {
+        const threadKey = new ThreadKey({
+            platform: event.platform,
+            teamOrGuildId: event.teamOrGuildId,
+            channelId: event.channelId,
+            threadId: event.threadId,
+        });
+        const question = this.deps.userQuestionRepository.findPendingByThreadKey(threadKey);
+        if (!question) {
+            return false;
+        }
+        const pending = this.pendingQuestions.get(question.questionId);
+        if (!pending) {
+            return false;
+        }
+        const cleaned = MessageCleaner.clean(event.rawText, event.platform, undefined, this.maxMessageLength).cleanedText;
+        question.receiveAnswer(cleaned);
+        this.deps.userQuestionRepository.save(question);
+        clearTimeout(pending.timer);
+        this.pendingQuestions.delete(question.questionId);
+        pending.resolve({
+            answered: true,
+            response: cleaned,
+            user_id: event.userId,
+            timestamp: event.timestamp,
+        });
+        return true;
+    }
+    resolveAdapter(platform) {
+        if (platform) {
+            const adapter = this.adaptersByPlatform.get(platform);
+            if (!adapter) {
+                throw new ValidationError(`Platform "${platform}" is not connected.`, {
+                    recoveryHint: "Specify a connected platform or start the chat daemon first.",
+                });
+            }
+            return adapter;
+        }
+        const adapters = [...this.adaptersByPlatform.values()];
+        if (adapters.length === 1) {
+            return adapters[0];
+        }
+        throw new ValidationError("platform is required when multiple chat platforms are connected.", {
+            recoveryHint: "Specify platform: slack or discord.",
+        });
+    }
+}
+//# sourceMappingURL=chat-question-service.js.map

package/dist/application/chat/chat-question-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-question-service.js","sourceRoot":"","sources":["../../../src/application/chat/chat-question-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,OAAO,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AAEtE,OAAO,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAC;AAChE,OAAO,EACL,aAAa,EACb,YAAY,GACb,MAAM,oCAAoC,CAAC;AAW5C,MAAM,OAAO,8BAA8B;IACxB,SAAS,GAAG,IAAI,GAAG,EAAwB,CAAC;IAEtD,sBAAsB,CAAC,GAAc;QAC1C,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC;YAC/C,IACE,QAAQ,CAAC,KAAK,KAAK,aAAa,CAAC,OAAO;gBACxC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC,EAChC,CAAC;gBACD,OAAO,QAAQ,CAAC;YAClB,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,IAAI,CAAC,QAAsB;QAChC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACpD,CAAC;CACF;AAQD,MAAM,OAAO,mBAAmB;IAMX;IALX,kBAAkB,CAAyC;IAClD,gBAAgB,GAAG,IAAI,GAAG,EAA2B,CAAC;IAC/D,gBAAgB,CAAS;IAEjC,YACmB,IAKhB;QALgB,SAAI,GAAJ,IAAI,CAKpB;QAED,IAAI,CAAC,kBAAkB,GAAG,IAAI,GAAG,EAAE,CAAC;QACpC,IAAI,CAAC,gBAAgB,GAAG,MAAM,CAAC;QAC/B,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;IACxC,CAAC;IAEM,WAAW,CAAC,QAA+B;QAChD,IAAI,CAAC,kBAAkB,GAAG,IAAI,GAAG,CAC/B,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CACvD,CAAC;IACJ,CAAC;IAEM,SAAS,CAAC,OAAsC;QACrD,IAAI,OAAO,CAAC,gBAAgB,KAAK,SAAS,EAAE,CAAC;YAC3C,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC;QAC5E,CAAC;IACH,CAAC;IAEM,sBAAsB,CAAC,GAAc;QAC1C,OAAO,IAAI,CAAC,IAAI,CAAC,sBAAsB,CAAC,sBAAsB,CAAC,GAAG,CAAC,CAAC;IACtE,CAAC;IAEM,KAAK,CAAC,GAAG,CACd,MAAc,EACd,YAAoB,EACpB,cAAc,GAAG,GAAG,EACpB,QAAuB,EACvB,OAAgB;QAEhB,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;QAC9C,MAAM,iBAAiB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC;QAClE,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,CAC/B,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,IAAI,UAAU,EAAE,EAC/C,MAAM,EACN,YAAY,EACZ,iBAAiB,CAClB,CAAC;QACF,IAAI,CAAC,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAEhD,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,WAAW,CAC1C;YACE,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,MAAM;YACN,SAAS,EAAE,OAAO;SACnB,EACD;YACE,OAAO,EAAE,YAAY;YACrB,MAAM,EAAE,UAAU;SACnB,CACF,CAAC;QAEF,MAAM,cAAc,GAAG,UAAU,CAAC,SAAS,IAAI,OAAO,CAAC;QACvD,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,MAAM,IAAI,eAAe,CAAC,sDAAsD,EAAE;gBAChF,YAAY,EACV,yFAAyF;aAC5F,CAAC,CAAC;QACL,CAAC;QAED,QAAQ,CAAC,QAAQ,CACf,IAAI,SAAS,CAAC;YACZ,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,aAAa,EAAE,UAAU,CAAC,aAAa;YACvC,SAAS,EAAE,cAAc;YACzB,QAAQ,EAAE,UAAU,CAAC,QAAQ;SAC9B,CAAC,CACH,CAAC;QACF,IAAI,CAAC,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAEhD,OAAO,IAAI,OAAO,CAAgB,CAAC,OAAO,EAAE,EAAE;YAC5C,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC5B,IAAI,QAAQ,CAAC,KAAK,KAAK,aAAa,CAAC,OAAO,EAAE,CAAC;oBAC7C,QAAQ,CAAC,YAAY,EAAE,CAAC;oBACxB,IAAI,CAAC,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBAClD,CAAC;gBACD,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;gBAClD,OAAO,CAAC;oBACN,QAAQ,EAAE,KAAK;oBACf,MAAM,EAAE,SAAS;iBAClB,CAAC,CAAC;YACL,CAAC,EAAE,iBAAiB,GAAG,KAAK,CAAC,CAAC;YAE9B,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,QAAQ,CAAC,UAAU,EAAE;gBAC7C,QAAQ;gBACR,OAAO;gBACP,KAAK;aACN,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAEM,KAAK,CAAC,qBAAqB,CAAC,KAAuB;QACxD,MAAM,SAAS,GAAG,IAAI,SAAS,CAAC;YAC9B,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,aAAa,EAAE,KAAK,CAAC,aAAa;YAClC,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,QAAQ,EAAE,KAAK,CAAC,QAAQ;SACzB,CAAC,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,sBAAsB,CAAC,sBAAsB,CAAC,SAAS,CAAC,CAAC;QACpF,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QAC/D,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,OAAO,GAAG,cAAc,CAAC,KAAK,CAClC,KAAK,CAAC,OAAO,EACb,KAAK,CAAC,QAAQ,EACd,SAAS,EACT,IAAI,CAAC,gBAAgB,CACtB,CAAC,WAAW,CAAC;QACd,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QAChC,IAAI,CAAC,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAEhD,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC5B,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QAClD,OAAO,CAAC,OAAO,CAAC;YACd,QAAQ,EAAE,IAAI;YACd,QAAQ,EAAE,OAAO;YACjB,OAAO,EAAE,KAAK,CAAC,MAAM;YACrB,SAAS,EAAE,KAAK,CAAC,SAAS;SAC3B,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,cAAc,CAAC,QAAuB;QAC5C,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACtD,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,IAAI,eAAe,CAAC,aAAa,QAAQ,qBAAqB,EAAE;oBACpE,YAAY,EAAE,8DAA8D;iBAC7E,CAAC,CAAC;YACL,CAAC;YACD,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,CAAC,kBAAkB,CAAC,MAAM,EAAE,CAAC,CAAC;QACvD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO,QAAQ,CAAC,CAAC,CAAE,CAAC;QACtB,CAAC;QAED,MAAM,IAAI,eAAe,CACvB,kEAAkE,EAClE;YACE,YAAY,EAAE,qCAAqC;SACpD,CACF,CAAC;IACJ,CAAC;CACF"}