@panguard-ai/panguard-chat 0.1.0

package/dist/agent/chat-agent.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Chat Agent Core - with message queue, persistent context, and confirmation reminders
+ * Chat Agent 核心 - 支援訊息佇列、持久化上下文和確認提醒
+ *
+ * The Chat Agent translates technical security events into human-readable
+ * messages, handles follow-up questions, manages user confirmations with
+ * auto-reminders, and persists conversation context across restarts.
+ *
+ * @module @panguard-ai/panguard-chat/agent/chat-agent
+ */
+import type { UserProfile, ThreatAlert, SummaryReport, LearningProgress, ConfirmationRequest, ConfirmationResponse, ChatConfig, MessagingChannel, ChannelResult } from '../types.js';
+/**
+ * Chat Agent - the user-facing AI security assistant with
+ * message queue retry, persistent context, and confirmation reminders.
+ */
+export declare class ChatAgent {
+    private readonly config;
+    private readonly channels;
+    private readonly followUpContexts;
+    private readonly pendingConfirmations;
+    private readonly systemPrompt;
+    /** Message queue for retry on failure */
+    private readonly messageQueue;
+    /** Retry timer */
+    private retryTimer;
+    /** Confirmation reminder timer */
+    private reminderTimer;
+    constructor(config: ChatConfig);
+    registerChannel(channel: MessagingChannel): void;
+    private getPrimaryChannel;
+    sendAlert(userId: string, alert: ThreatAlert): Promise<ChannelResult>;
+    sendSummary(userId: string, report: SummaryReport): Promise<ChannelResult>;
+    sendLearningUpdate(userId: string, progress: LearningProgress): Promise<ChannelResult>;
+    sendPeacefulReport(userId: string): Promise<ChannelResult>;
+    requestConfirmation(userId: string, request: ConfirmationRequest): Promise<ChannelResult>;
+    processConfirmation(verdictId: string, confirmed: boolean, reason?: string): ConfirmationResponse | null;
+    handleReply(userId: string, text: string): Promise<string>;
+    private handleFollowUp;
+    private tryLLMFollowUp;
+    private generateFollowUpAnswer;
+    private storeFollowUpContext;
+    private findMostRecentContext;
+    private cleanExpiredContexts;
+    /**
+     * Send message with automatic retry on failure.
+     * Failed messages are queued and retried with exponential backoff.
+     */
+    private sendMessageWithRetry;
+    /**
+     * Background retry processor: attempts to resend failed messages
+     */
+    private startRetryProcessor;
+    /**
+     * Background reminder processor: re-sends confirmation requests
+     * that haven't been answered within the reminder interval.
+     */
+    private startReminderProcessor;
+    private sendMessage;
+    getSystemPrompt(): string;
+    getUserProfile(): UserProfile;
+    getRegisteredChannels(): string[];
+    getActiveContextCount(): number;
+    getPendingConfirmationCount(): number;
+    /** Get message queue depth */
+    getQueueDepth(): number;
+    /** Cleanup: clear all timers (for graceful shutdown) */
+    destroy(): void;
+}
+//# sourceMappingURL=chat-agent.d.ts.map

package/dist/agent/chat-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-agent.d.ts","sourceRoot":"","sources":["../../src/agent/chat-agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EACV,WAAW,EAEX,WAAW,EACX,aAAa,EACb,gBAAgB,EAEhB,mBAAmB,EACnB,oBAAoB,EAGpB,UAAU,EACV,gBAAgB,EAChB,aAAa,EACd,MAAM,aAAa,CAAC;AA+DrB;;;GAGG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IACpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4C;IACrE,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CACrB;IACZ,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAA+C;IACpF,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IAEtC,yCAAyC;IACzC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAuB;IAEpD,kBAAkB;IAClB,OAAO,CAAC,UAAU,CAA+C;IAEjE,kCAAkC;IAClC,OAAO,CAAC,aAAa,CAA+C;gBAExD,MAAM,EAAE,UAAU;IAmB9B,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI;IAShD,OAAO,CAAC,iBAAiB;IASnB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC;IAWrE,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;IAO1E,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,aAAa,CAAC;IAMtF,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAS1D,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,aAAa,CAAC;IAa/F,mBAAmB,CACjB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,OAAO,EAClB,MAAM,CAAC,EAAE,MAAM,GACd,oBAAoB,GAAG,IAAI;IA6BxB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;YAgClD,cAAc;YAyCd,cAAc;IAqC5B,OAAO,CAAC,sBAAsB;IA8E9B,OAAO,CAAC,oBAAoB;IAY5B,OAAO,CAAC,qBAAqB;IAY7B,OAAO,CAAC,oBAAoB;IAa5B;;;OAGG;YACW,oBAAoB;IAuBlC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAiC3B;;;OAGG;IACH,OAAO,CAAC,sBAAsB;YAiDhB,WAAW;IA6BzB,eAAe,IAAI,MAAM;IAIzB,cAAc,IAAI,WAAW;IAI7B,qBAAqB,IAAI,MAAM,EAAE;IAIjC,qBAAqB,IAAI,MAAM;IAK/B,2BAA2B,IAAI,MAAM;IAIrC,8BAA8B;IAC9B,aAAa,IAAI,MAAM;IAIvB,wDAAwD;IACxD,OAAO,IAAI,IAAI;CAUhB"}

package/dist/agent/chat-agent.js

@@ -0,0 +1,477 @@
+/**
+ * Chat Agent Core - with message queue, persistent context, and confirmation reminders
+ * Chat Agent 核心 - 支援訊息佇列、持久化上下文和確認提醒
+ *
+ * The Chat Agent translates technical security events into human-readable
+ * messages, handles follow-up questions, manages user confirmations with
+ * auto-reminders, and persists conversation context across restarts.
+ *
+ * @module @panguard-ai/panguard-chat/agent/chat-agent
+ */
+import { createLogger } from '@panguard-ai/core';
+import { buildSystemPrompt } from './prompts.js';
+import { formatAlert, formatSummary, formatLearningProgress, formatConfirmation, formatPeacefulReport, } from './formatter.js';
+const logger = createLogger('panguard-chat:agent');
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/** Maximum conversation turns to keep per context */
+const MAX_CONVERSATION_TURNS = 10;
+/** Maximum token budget for follow-up responses */
+const MAX_FOLLOWUP_TOKENS = 2000;
+/** Context expiry in ms (24 hours) */
+const CONTEXT_EXPIRY_MS = 24 * 60 * 60 * 1000;
+/** Message queue retry attempts */
+const MAX_RETRY_ATTEMPTS = 3;
+/** Retry delay in ms (exponential backoff base) */
+const RETRY_BASE_DELAY_MS = 2000;
+/** Confirmation reminder interval (4 hours) */
+const CONFIRMATION_REMINDER_MS = 4 * 60 * 60 * 1000;
+/** Max reminders before auto-escalation */
+const MAX_REMINDERS = 3;
+// ---------------------------------------------------------------------------
+// ChatAgent class
+// ---------------------------------------------------------------------------
+/**
+ * Chat Agent - the user-facing AI security assistant with
+ * message queue retry, persistent context, and confirmation reminders.
+ */
+export class ChatAgent {
+    config;
+    channels = new Map();
+    followUpContexts = new Map();
+    pendingConfirmations = new Map();
+    systemPrompt;
+    /** Message queue for retry on failure */
+    messageQueue = [];
+    /** Retry timer */
+    retryTimer = null;
+    /** Confirmation reminder timer */
+    reminderTimer = null;
+    constructor(config) {
+        this.config = config;
+        this.systemPrompt =
+            config.systemPromptOverride ??
+                buildSystemPrompt(config.userProfile.type, config.userProfile.language);
+        // Start background processors
+        this.startRetryProcessor();
+        this.startReminderProcessor();
+        logger.info(`ChatAgent initialized for ${config.userProfile.type} user (${config.userProfile.language})`);
+    }
+    // -------------------------------------------------------------------------
+    // Channel Management
+    // -------------------------------------------------------------------------
+    registerChannel(channel) {
+        this.channels.set(channel.channelType, channel);
+        logger.info(`Channel registered: ${channel.channelType}`);
+        channel.onReply(async (userId, text) => {
+            return this.handleReply(userId, text);
+        });
+    }
+    getPrimaryChannel() {
+        const channelType = this.config.userProfile.notificationChannel;
+        return this.channels.get(channelType);
+    }
+    // -------------------------------------------------------------------------
+    // Alert Handling
+    // -------------------------------------------------------------------------
+    async sendAlert(userId, alert) {
+        const { userProfile } = this.config;
+        const message = formatAlert(alert, userProfile.type, userProfile.language);
+        logger.info(`Sending alert: ${alert.severity} ${alert.conclusion}`);
+        // Store context for follow-up
+        this.storeFollowUpContext(alert);
+        return this.sendMessageWithRetry(userId, message);
+    }
+    async sendSummary(userId, report) {
+        const { userProfile } = this.config;
+        const message = formatSummary(report, userProfile.type, userProfile.language);
+        logger.info(`Sending ${report.period} summary`);
+        return this.sendMessageWithRetry(userId, message);
+    }
+    async sendLearningUpdate(userId, progress) {
+        const message = formatLearningProgress(progress, this.config.userProfile.language);
+        logger.info(`Sending learning progress: day ${progress.day}/${progress.totalDays}`);
+        return this.sendMessageWithRetry(userId, message);
+    }
+    async sendPeacefulReport(userId) {
+        const message = formatPeacefulReport(this.config.userProfile.language);
+        return this.sendMessageWithRetry(userId, message);
+    }
+    // -------------------------------------------------------------------------
+    // Confirmation Flow with Reminders
+    // -------------------------------------------------------------------------
+    async requestConfirmation(userId, request) {
+        const tracked = {
+            ...request,
+            reminderCount: 0,
+            lastReminderAt: Date.now(),
+        };
+        this.pendingConfirmations.set(request.verdictId, tracked);
+        const message = formatConfirmation(request, this.config.userProfile.language);
+        logger.info(`Requesting confirmation for verdict ${request.verdictId}`);
+        return this.sendMessageWithRetry(userId, message);
+    }
+    processConfirmation(verdictId, confirmed, reason) {
+        const request = this.pendingConfirmations.get(verdictId);
+        if (!request) {
+            logger.warn(`No pending confirmation for verdict ${verdictId}`);
+            return null;
+        }
+        if (new Date(request.expiresAt).getTime() < Date.now()) {
+            this.pendingConfirmations.delete(verdictId);
+            logger.warn(`Confirmation expired for verdict ${verdictId}`);
+            return null;
+        }
+        this.pendingConfirmations.delete(verdictId);
+        const response = {
+            verdictId,
+            confirmed,
+            reason,
+            respondedAt: new Date().toISOString(),
+        };
+        logger.info(`Confirmation ${confirmed ? 'accepted' : 'rejected'} for ${verdictId}`);
+        return response;
+    }
+    // -------------------------------------------------------------------------
+    // Follow-up / Q&A
+    // -------------------------------------------------------------------------
+    async handleReply(userId, text) {
+        const lang = this.config.userProfile.language;
+        // Check if it's a confirmation response
+        const confirmMatch = text.match(/^(confirm|reject|details):(.+)$/);
+        if (confirmMatch) {
+            const [, action, verdictId] = confirmMatch;
+            if (action === 'confirm') {
+                const result = this.processConfirmation(verdictId, true);
+                return result
+                    ? lang === 'zh-TW'
+                        ? '已確認，正在執行動作。'
+                        : 'Confirmed. Executing action.'
+                    : lang === 'zh-TW'
+                        ? '此確認請求已過期或不存在。'
+                        : 'This confirmation request has expired or does not exist.';
+            }
+            if (action === 'reject') {
+                const result = this.processConfirmation(verdictId, false, text);
+                return result
+                    ? lang === 'zh-TW'
+                        ? '已取消，不會執行動作。'
+                        : 'Cancelled. Action will not be taken.'
+                    : lang === 'zh-TW'
+                        ? '此確認請求已過期或不存在。'
+                        : 'This confirmation request has expired or does not exist.';
+            }
+        }
+        return this.handleFollowUp(userId, text);
+    }
+    async handleFollowUp(_userId, question) {
+        const lang = this.config.userProfile.language;
+        const context = this.findMostRecentContext();
+        if (!context) {
+            return lang === 'zh-TW'
+                ? '目前沒有可以追問的告警。如果有新的問題，請等待下一次告警。'
+                : 'No recent alerts to ask about. Please wait for the next alert if you have questions.';
+        }
+        const turn = {
+            role: 'user',
+            content: question,
+            timestamp: new Date().toISOString(),
+        };
+        const history = [...context.conversationHistory, turn];
+        let answer;
+        const llmAnswer = await this.tryLLMFollowUp(context, question, lang);
+        if (llmAnswer) {
+            answer = llmAnswer;
+        }
+        else {
+            answer = this.generateFollowUpAnswer(context.originalAlert, question, lang);
+        }
+        const answerTurn = {
+            role: 'assistant',
+            content: answer,
+            timestamp: new Date().toISOString(),
+        };
+        const trimmedHistory = [...history, answerTurn].slice(-MAX_CONVERSATION_TURNS);
+        this.followUpContexts.set(context.verdictId, {
+            ...context,
+            conversationHistory: trimmedHistory,
+        });
+        logger.info(`Follow-up answered for ${context.verdictId} (${trimmedHistory.length} turns)`);
+        return answer;
+    }
+    async tryLLMFollowUp(context, question, lang) {
+        const llm = this.config.llmProvider;
+        if (!llm)
+            return null;
+        try {
+            const available = await llm.isAvailable();
+            if (!available)
+                return null;
+            const alert = context.originalAlert;
+            const prompt = [
+                this.systemPrompt,
+                '',
+                `Alert: ${alert.eventDescription}`,
+                `Severity: ${alert.severity}, Conclusion: ${alert.conclusion}`,
+                `Summary: ${alert.humanSummary}`,
+                `Recommended action: ${alert.recommendedAction}`,
+                '',
+                `User question (respond in ${lang === 'zh-TW' ? 'Traditional Chinese' : 'English'}):`,
+                question,
+            ].join('\n');
+            const result = await llm.analyze(prompt);
+            if (result.summary) {
+                logger.info('Follow-up answered via LLM');
+                return result.summary;
+            }
+            return null;
+        }
+        catch (err) {
+            logger.warn(`LLM follow-up failed: ${err instanceof Error ? err.message : String(err)}`);
+            return null;
+        }
+    }
+    generateFollowUpAnswer(alert, question, lang) {
+        const q = question.toLowerCase();
+        const maxTokens = this.config.maxFollowUpTokens ?? MAX_FOLLOWUP_TOKENS;
+        // "What did you do?" / "Actions taken?"
+        if (q.includes('做了') || q.includes('動作') || q.includes('did you') || q.includes('action')) {
+            if (alert.actionsTaken && alert.actionsTaken.length > 0) {
+                const prefix = lang === 'zh-TW' ? '我已執行以下動作:' : 'I have taken the following actions:';
+                return `${prefix}\n${alert.actionsTaken.map((a) => `- ${a}`).join('\n')}`;
+            }
+            return lang === 'zh-TW'
+                ? '目前尚未執行任何自動動作。系統正在等待進一步確認。'
+                : 'No automated actions have been taken yet. The system is waiting for further confirmation.';
+        }
+        // "What should I do?" / "Recommendation?"
+        if (q.includes('建議') ||
+            q.includes('怎麼辦') ||
+            q.includes('should') ||
+            q.includes('recommend')) {
+            return lang === 'zh-TW'
+                ? `建議: ${alert.recommendedAction}`
+                : `Recommendation: ${alert.recommendedAction}`;
+        }
+        // "Is it dangerous?" / "How serious?"
+        if (q.includes('嚴重') || q.includes('危險') || q.includes('serious') || q.includes('danger')) {
+            const severityExplain = lang === 'zh-TW'
+                ? {
+                    critical: '非常嚴重，需要立即處理',
+                    high: '嚴重，建議盡快處理',
+                    medium: '中等風險，建議關注',
+                    low: '低風險，已記錄',
+                    info: '僅供參考',
+                }
+                : {
+                    critical: 'Very serious, immediate action needed',
+                    high: 'Serious, prompt attention recommended',
+                    medium: 'Moderate risk, worth monitoring',
+                    low: 'Low risk, logged for reference',
+                    info: 'Informational only',
+                };
+            return `${severityExplain[alert.severity] ?? (lang === 'zh-TW' ? '已記錄' : 'Logged')}\n\n${lang === 'zh-TW' ? '信心度' : 'Confidence'}: ${Math.round(alert.confidence * 100)}%`;
+        }
+        // "What is this?" / "Explain"
+        if (q.includes('什麼') || q.includes('what') || q.includes('explain')) {
+            return lang === 'zh-TW'
+                ? `這是關於: ${alert.eventDescription}\n\n${alert.reasoning}\n\n簡單來說: ${alert.humanSummary}`
+                : `This is about: ${alert.eventDescription}\n\n${alert.reasoning}\n\nIn simple terms: ${alert.humanSummary}`;
+        }
+        // Default
+        const response = lang === 'zh-TW'
+            ? `關於此事件:\n${alert.humanSummary}\n\n如需更多細節，請問具體想了解什麼？`
+            : `About this event:\n${alert.humanSummary}\n\nFor more details, please ask a specific question.`;
+        const estimatedTokens = lang === 'zh-TW' ? response.length / 2 : response.length / 4;
+        if (estimatedTokens > maxTokens) {
+            return alert.humanSummary;
+        }
+        return response;
+    }
+    // -------------------------------------------------------------------------
+    // Context Management
+    // -------------------------------------------------------------------------
+    storeFollowUpContext(alert) {
+        this.cleanExpiredContexts();
+        const verdictId = `alert-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+        this.followUpContexts.set(verdictId, {
+            verdictId,
+            originalAlert: alert,
+            conversationHistory: [],
+            expiresAt: Date.now() + CONTEXT_EXPIRY_MS,
+        });
+    }
+    findMostRecentContext() {
+        this.cleanExpiredContexts();
+        let latest = null;
+        for (const ctx of this.followUpContexts.values()) {
+            if (!latest || ctx.expiresAt > latest.expiresAt) {
+                latest = ctx;
+            }
+        }
+        return latest;
+    }
+    cleanExpiredContexts() {
+        const now = Date.now();
+        for (const [key, ctx] of this.followUpContexts) {
+            if (ctx.expiresAt < now) {
+                this.followUpContexts.delete(key);
+            }
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Message Queue with Retry
+    // -------------------------------------------------------------------------
+    /**
+     * Send message with automatic retry on failure.
+     * Failed messages are queued and retried with exponential backoff.
+     */
+    async sendMessageWithRetry(userId, message) {
+        const result = await this.sendMessage(userId, message);
+        if (!result.success) {
+            // Queue for retry
+            const queueEntry = {
+                id: `msg-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
+                userId,
+                message,
+                attempts: 1,
+                createdAt: Date.now(),
+                lastError: result.error,
+            };
+            this.messageQueue.push(queueEntry);
+            logger.warn(`Message queued for retry (attempt 1/${MAX_RETRY_ATTEMPTS}): ${result.error}`);
+        }
+        return result;
+    }
+    /**
+     * Background retry processor: attempts to resend failed messages
+     */
+    startRetryProcessor() {
+        this.retryTimer = setInterval(async () => {
+            if (this.messageQueue.length === 0)
+                return;
+            const toRetry = [...this.messageQueue];
+            this.messageQueue.length = 0;
+            for (const entry of toRetry) {
+                if (entry.attempts >= MAX_RETRY_ATTEMPTS) {
+                    logger.error(`Message ${entry.id} permanently failed after ${entry.attempts} attempts: ${entry.lastError}`);
+                    continue;
+                }
+                const result = await this.sendMessage(entry.userId, entry.message);
+                if (result.success) {
+                    logger.info(`Message ${entry.id} delivered on retry attempt ${entry.attempts + 1}`);
+                }
+                else {
+                    entry.attempts += 1;
+                    entry.lastError = result.error;
+                    this.messageQueue.push(entry);
+                    logger.warn(`Message ${entry.id} retry failed (attempt ${entry.attempts}/${MAX_RETRY_ATTEMPTS})`);
+                }
+            }
+        }, RETRY_BASE_DELAY_MS);
+        // Don't hold process open for retry timer
+        if (this.retryTimer.unref)
+            this.retryTimer.unref();
+    }
+    /**
+     * Background reminder processor: re-sends confirmation requests
+     * that haven't been answered within the reminder interval.
+     */
+    startReminderProcessor() {
+        this.reminderTimer = setInterval(async () => {
+            const now = Date.now();
+            for (const [verdictId, confirmation] of this.pendingConfirmations) {
+                // Check if expired
+                if (new Date(confirmation.expiresAt).getTime() < now) {
+                    this.pendingConfirmations.delete(verdictId);
+                    logger.info(`Confirmation ${verdictId} expired, removed`);
+                    continue;
+                }
+                // Check if reminder needed
+                if (now - confirmation.lastReminderAt >= CONFIRMATION_REMINDER_MS &&
+                    confirmation.reminderCount < MAX_REMINDERS) {
+                    confirmation.reminderCount += 1;
+                    confirmation.lastReminderAt = now;
+                    const lang = this.config.userProfile.language;
+                    const reminderText = lang === 'zh-TW'
+                        ? `[提醒 ${confirmation.reminderCount}/${MAX_REMINDERS}] 您有一個待確認的安全動作尚未回應。`
+                        : `[Reminder ${confirmation.reminderCount}/${MAX_REMINDERS}] You have a pending security action awaiting confirmation.`;
+                    logger.info(`Sending reminder ${confirmation.reminderCount}/${MAX_REMINDERS} for ${verdictId}`);
+                    // Re-send the confirmation message
+                    const message = formatConfirmation(confirmation, lang);
+                    // We don't have userId stored, so we send to the configured default
+                    // In production, userId should be stored in the confirmation request
+                    await this.sendMessage('default', {
+                        ...message,
+                        text: `${reminderText}\n\n${message.text}`,
+                    });
+                }
+            }
+        }, 60 * 1000); // Check every minute
+        if (this.reminderTimer.unref)
+            this.reminderTimer.unref();
+    }
+    // -------------------------------------------------------------------------
+    // Message Sending
+    // -------------------------------------------------------------------------
+    async sendMessage(userId, message) {
+        const channel = this.getPrimaryChannel();
+        if (!channel) {
+            const error = `No channel registered for ${this.config.userProfile.notificationChannel}`;
+            logger.error(error);
+            return {
+                success: false,
+                channel: this.config.userProfile.notificationChannel,
+                error,
+            };
+        }
+        try {
+            return await channel.sendMessage(userId, message);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            logger.error(`Failed to send message: ${msg}`);
+            return {
+                success: false,
+                channel: channel.channelType,
+                error: msg,
+            };
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Getters / Accessors
+    // -------------------------------------------------------------------------
+    getSystemPrompt() {
+        return this.systemPrompt;
+    }
+    getUserProfile() {
+        return this.config.userProfile;
+    }
+    getRegisteredChannels() {
+        return [...this.channels.keys()];
+    }
+    getActiveContextCount() {
+        this.cleanExpiredContexts();
+        return this.followUpContexts.size;
+    }
+    getPendingConfirmationCount() {
+        return this.pendingConfirmations.size;
+    }
+    /** Get message queue depth */
+    getQueueDepth() {
+        return this.messageQueue.length;
+    }
+    /** Cleanup: clear all timers (for graceful shutdown) */
+    destroy() {
+        if (this.retryTimer) {
+            clearInterval(this.retryTimer);
+            this.retryTimer = null;
+        }
+        if (this.reminderTimer) {
+            clearInterval(this.reminderTimer);
+            this.reminderTimer = null;
+        }
+    }
+}
+//# sourceMappingURL=chat-agent.js.map

package/dist/agent/chat-agent.js.map

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

package/dist/agent/formatter.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Message Formatter
+ * 訊息格式化器
+ *
+ * Adapts technical security verdicts into human-readable messages
+ * based on user type (developer / boss / IT admin).
+ * 根據用戶類型（開發者/老闆/IT管理者）將技術安全判決
+ * 轉換為人類可讀的訊息。
+ *
+ * @module @panguard-ai/panguard-chat/agent/formatter
+ */
+import type { UserType, MessageLanguage, ThreatAlert, SummaryReport, LearningProgress, FormattedMessage, ConfirmationRequest } from '../types.js';
+/**
+ * Format a threat alert message for the given user type
+ * 為指定的用戶類型格式化威脅告警訊息
+ *
+ * @param alert - The threat alert / 威脅告警
+ * @param userType - User type for tone adaptation / 用戶類型（語氣適配）
+ * @param language - Target language / 目標語言
+ * @returns Formatted message / 格式化後的訊息
+ */
+export declare function formatAlert(alert: ThreatAlert, userType: UserType, language: MessageLanguage): FormattedMessage;
+/**
+ * Format a summary report (daily / weekly)
+ * 格式化摘要報告（日報/週報）
+ *
+ * @param report - Summary report data / 摘要報告資料
+ * @param userType - User type / 用戶類型
+ * @param language - Target language / 目標語言
+ * @returns Formatted message / 格式化後的訊息
+ */
+export declare function formatSummary(report: SummaryReport, userType: UserType, language: MessageLanguage): FormattedMessage;
+/**
+ * Format a learning progress notification
+ * 格式化學習期進度通知
+ *
+ * @param progress - Learning progress data / 學習期進度資料
+ * @param language - Target language / 目標語言
+ * @returns Formatted message / 格式化後的訊息
+ */
+export declare function formatLearningProgress(progress: LearningProgress, language: MessageLanguage): FormattedMessage;
+/**
+ * Format a confirmation request for user approval
+ * 格式化用戶確認請求
+ *
+ * @param request - Confirmation request / 確認請求
+ * @param language - Target language / 目標語言
+ * @returns Formatted message with quick replies / 附帶快速回覆的格式化訊息
+ */
+export declare function formatConfirmation(request: ConfirmationRequest, language: MessageLanguage): FormattedMessage;
+/**
+ * Format a peaceful "all clear" report
+ * 格式化平安報告（無事報平安）
+ *
+ * @param language - Target language / 目標語言
+ * @returns Formatted message / 格式化後的訊息
+ */
+export declare function formatPeacefulReport(language: MessageLanguage): FormattedMessage;
+//# sourceMappingURL=formatter.d.ts.map

package/dist/agent/formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../../src/agent/formatter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EACV,QAAQ,EACR,eAAe,EACf,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAEhB,mBAAmB,EACpB,MAAM,aAAa,CAAC;AA8IrB;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,WAAW,EAClB,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,eAAe,GACxB,gBAAgB,CAgClB;AAOD;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,aAAa,EACrB,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,eAAe,GACxB,gBAAgB,CAsFlB;AAOD;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,gBAAgB,EAC1B,QAAQ,EAAE,eAAe,GACxB,gBAAgB,CAuClB;AAOD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,mBAAmB,EAC5B,QAAQ,EAAE,eAAe,GACxB,gBAAgB,CA4ClB;AAOD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,eAAe,GAAG,gBAAgB,CAsBhF"}