@panguard-ai/panguard-guard 0.1.0

package/dist/notify/email.js

@@ -0,0 +1,124 @@
+/**
+ * Email SMTP notification integration
+ * Email SMTP 通知整合
+ *
+ * Sends threat alerts via raw SMTP without external dependencies.
+ * Uses Node.js net/tls modules for direct SMTP communication.
+ * 透過原始 SMTP 發送威脅警報，不使用外部相依套件。
+ * 使用 Node.js net/tls 模組進行直接 SMTP 通訊。
+ *
+ * @module @panguard-ai/panguard-guard/notify/email
+ */
+import * as net from 'node:net';
+import * as tls from 'node:tls';
+import { createLogger } from '@panguard-ai/core';
+const logger = createLogger('panguard-guard:notify:email');
+/**
+ * Send a threat alert via Email (raw SMTP)
+ * 透過 Email (原始 SMTP) 發送威脅警報
+ *
+ * @param config - Email SMTP configuration / Email SMTP 配置
+ * @param verdict - The threat verdict / 威脅判決
+ * @param eventDescription - Event description / 事件描述
+ * @returns Notification result / 通知結果
+ */
+export async function sendEmailNotify(config, verdict, eventDescription) {
+    const subject = `[PanguardGuard] ${verdict.conclusion.toUpperCase()} Alert - Confidence ${verdict.confidence}%`;
+    const body = `PanguardGuard Security Alert\n` +
+        `========================\n\n` +
+        `Conclusion: ${verdict.conclusion}\n` +
+        `Confidence: ${verdict.confidence}%\n` +
+        `Recommended Action: ${verdict.recommendedAction}\n` +
+        `${verdict.mitreTechnique ? `MITRE ATT&CK: ${verdict.mitreTechnique}\n` : ''}` +
+        `\nEvent Description:\n${eventDescription}\n` +
+        `\nEvidence:\n${verdict.evidence.map((e) => `  - [${e.source}] ${e.description} (${e.confidence}%)`).join('\n')}\n` +
+        `\nReasoning:\n${verdict.reasoning}\n` +
+        `\nTimestamp: ${new Date().toISOString()}\n`;
+    try {
+        for (const recipient of config.to) {
+            await sendSMTP(config, recipient, subject, body);
+        }
+        logger.info(`Email notification sent to ${config.to.length} recipients / Email 通知已發送`);
+        return { channel: 'email', success: true };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        logger.error(`Email notification failed: ${msg} / Email 通知失敗: ${msg}`);
+        return { channel: 'email', success: false, error: msg };
+    }
+}
+/**
+ * Send email via raw SMTP protocol / 透過原始 SMTP 協定發送電子郵件
+ */
+function sendSMTP(config, to, subject, body) {
+    return new Promise((resolve, reject) => {
+        const commands = [
+            `EHLO panguard-guard`,
+            `AUTH LOGIN`,
+            Buffer.from(config.auth.user).toString('base64'),
+            Buffer.from(config.auth.pass).toString('base64'),
+            `MAIL FROM:<${config.from}>`,
+            `RCPT TO:<${to}>`,
+            `DATA`,
+            `From: ${config.from}\r\nTo: ${to}\r\nSubject: ${subject}\r\nContent-Type: text/plain; charset=utf-8\r\n\r\n${body}\r\n.`,
+            `QUIT`,
+        ];
+        let commandIndex = 0;
+        let resolved = false;
+        const onConnect = (socket) => {
+            let buffer = '';
+            socket.on('data', (data) => {
+                buffer += data.toString();
+                // Process complete SMTP responses (ending with \r\n)
+                // 處理完整的 SMTP 回應（以 \r\n 結尾）
+                while (buffer.includes('\r\n')) {
+                    const lineEnd = buffer.indexOf('\r\n');
+                    const line = buffer.slice(0, lineEnd);
+                    buffer = buffer.slice(lineEnd + 2);
+                    const code = parseInt(line.slice(0, 3), 10);
+                    // Multi-line responses (code followed by dash) / 多行回應
+                    if (line[3] === '-')
+                        continue;
+                    // Check for errors / 檢查錯誤
+                    if (code >= 400) {
+                        if (!resolved) {
+                            resolved = true;
+                            socket.destroy();
+                            reject(new Error(`SMTP error ${code}: ${line}`));
+                        }
+                        return;
+                    }
+                    // Send next command / 發送下一個命令
+                    if (commandIndex < commands.length) {
+                        socket.write(commands[commandIndex] + '\r\n');
+                        commandIndex++;
+                    }
+                    else if (!resolved) {
+                        resolved = true;
+                        socket.destroy();
+                        resolve();
+                    }
+                }
+            });
+            socket.on('error', (err) => {
+                if (!resolved) {
+                    resolved = true;
+                    reject(err);
+                }
+            });
+            socket.on('close', () => {
+                if (!resolved) {
+                    resolved = true;
+                    resolve();
+                }
+            });
+        };
+        if (config.secure) {
+            const socket = tls.connect({ host: config.host, port: config.port }, () => onConnect(socket));
+        }
+        else {
+            const socket = net.connect({ host: config.host, port: config.port }, () => onConnect(socket));
+        }
+    });
+}
+//# sourceMappingURL=email.js.map

package/dist/notify/email.js.map

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

package/dist/notify/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Notification System
+ * 通知系統
+ *
+ * Dispatches threat alerts to configured notification channels:
+ * Telegram Bot, Slack Webhook, Email SMTP.
+ * 將威脅警報派發至已配置的通知通道：
+ * Telegram Bot、Slack Webhook、Email SMTP。
+ *
+ * @module @panguard-ai/panguard-guard/notify
+ */
+import type { NotificationConfig, NotificationResult, ThreatVerdict } from '../types.js';
+export { sendTelegramNotify } from './telegram.js';
+export { sendSlackNotify } from './slack.js';
+export { sendEmailNotify } from './email.js';
+/**
+ * Send notifications to all configured channels
+ * 向所有已配置的通道發送通知
+ *
+ * Dispatches alerts in parallel to all configured channels and
+ * collects results. Never throws - all errors are captured in results.
+ * 平行向所有已配置的通道派發警報並收集結果。
+ * 永不拋出錯誤 - 所有錯誤都會被捕獲在結果中。
+ *
+ * @param config - Notification configuration / 通知配置
+ * @param verdict - The threat verdict to notify about / 要通知的威脅判決
+ * @param eventDescription - Human-readable event description / 人類可讀的事件描述
+ * @returns Array of notification results for each channel / 各通道的通知結果陣列
+ */
+export declare function sendNotifications(config: NotificationConfig, verdict: ThreatVerdict, eventDescription: string): Promise<NotificationResult[]>;
+//# sourceMappingURL=index.d.ts.map

package/dist/notify/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/notify/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAOzF,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C;;;;;;;;;;;;;GAaG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,kBAAkB,EAC1B,OAAO,EAAE,aAAa,EACtB,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,kBAAkB,EAAE,CAAC,CA0C/B"}

package/dist/notify/index.js

@@ -0,0 +1,70 @@
+/**
+ * Notification System
+ * 通知系統
+ *
+ * Dispatches threat alerts to configured notification channels:
+ * Telegram Bot, Slack Webhook, Email SMTP.
+ * 將威脅警報派發至已配置的通知通道：
+ * Telegram Bot、Slack Webhook、Email SMTP。
+ *
+ * @module @panguard-ai/panguard-guard/notify
+ */
+import { createLogger } from '@panguard-ai/core';
+import { sendTelegramNotify } from './telegram.js';
+import { sendSlackNotify } from './slack.js';
+import { sendEmailNotify } from './email.js';
+const logger = createLogger('panguard-guard:notify');
+export { sendTelegramNotify } from './telegram.js';
+export { sendSlackNotify } from './slack.js';
+export { sendEmailNotify } from './email.js';
+/**
+ * Send notifications to all configured channels
+ * 向所有已配置的通道發送通知
+ *
+ * Dispatches alerts in parallel to all configured channels and
+ * collects results. Never throws - all errors are captured in results.
+ * 平行向所有已配置的通道派發警報並收集結果。
+ * 永不拋出錯誤 - 所有錯誤都會被捕獲在結果中。
+ *
+ * @param config - Notification configuration / 通知配置
+ * @param verdict - The threat verdict to notify about / 要通知的威脅判決
+ * @param eventDescription - Human-readable event description / 人類可讀的事件描述
+ * @returns Array of notification results for each channel / 各通道的通知結果陣列
+ */
+export async function sendNotifications(config, verdict, eventDescription) {
+    const promises = [];
+    if (config.telegram) {
+        promises.push(sendTelegramNotify(config.telegram, verdict, eventDescription));
+    }
+    if (config.slack) {
+        promises.push(sendSlackNotify(config.slack, verdict, eventDescription));
+    }
+    if (config.email) {
+        promises.push(sendEmailNotify(config.email, verdict, eventDescription));
+    }
+    if (promises.length === 0) {
+        logger.info('No notification channels configured / 未配置通知通道');
+        return [];
+    }
+    const results = await Promise.allSettled(promises);
+    const notificationResults = [];
+    for (const result of results) {
+        if (result.status === 'fulfilled') {
+            notificationResults.push(result.value);
+        }
+        else {
+            const msg = result.reason instanceof Error ? result.reason.message : String(result.reason);
+            logger.error(`Notification failed: ${msg} / 通知失敗: ${msg}`);
+            notificationResults.push({
+                channel: 'telegram', // fallback channel name
+                success: false,
+                error: msg,
+            });
+        }
+    }
+    const successCount = notificationResults.filter((r) => r.success).length;
+    logger.info(`Notifications sent: ${successCount}/${notificationResults.length} successful / ` +
+        `通知發送: ${successCount}/${notificationResults.length} 成功`);
+    return notificationResults;
+}
+//# sourceMappingURL=index.js.map

package/dist/notify/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/notify/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,MAAM,GAAG,YAAY,CAAC,uBAAuB,CAAC,CAAC;AAErD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAA0B,EAC1B,OAAsB,EACtB,gBAAwB;IAExB,MAAM,QAAQ,GAAkC,EAAE,CAAC;IAEnD,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpB,QAAQ,CAAC,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC;IAChF,CAAC;IACD,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,QAAQ,CAAC,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC;IAC1E,CAAC;IACD,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,QAAQ,CAAC,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC;IAC1E,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAC;QAC7D,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IACnD,MAAM,mBAAmB,GAAyB,EAAE,CAAC;IAErD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;YAClC,mBAAmB,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACzC,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,YAAY,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAC3F,MAAM,CAAC,KAAK,CAAC,wBAAwB,GAAG,YAAY,GAAG,EAAE,CAAC,CAAC;YAC3D,mBAAmB,CAAC,IAAI,CAAC;gBACvB,OAAO,EAAE,UAAU,EAAE,wBAAwB;gBAC7C,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,GAAG;aACX,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,MAAM,YAAY,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;IACzE,MAAM,CAAC,IAAI,CACT,uBAAuB,YAAY,IAAI,mBAAmB,CAAC,MAAM,gBAAgB;QAC/E,SAAS,YAAY,IAAI,mBAAmB,CAAC,MAAM,KAAK,CAC3D,CAAC;IAEF,OAAO,mBAAmB,CAAC;AAC7B,CAAC"}

package/dist/notify/line-notify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"line-notify.d.ts","sourceRoot":"","sources":["../../src/notify/line-notify.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAMvF;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,aAAa,EACtB,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,kBAAkB,CAAC,CAmB7B"}

package/dist/notify/slack.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Slack Webhook notification integration
+ * Slack Webhook 通知整合
+ *
+ * Sends threat alerts to Slack channels via Incoming Webhooks.
+ * 透過 Incoming Webhooks 將威脅警報發送至 Slack 頻道。
+ *
+ * @module @panguard-ai/panguard-guard/notify/slack
+ */
+import type { SlackConfig, NotificationResult, ThreatVerdict } from '../types.js';
+/**
+ * Send a threat alert via Slack Webhook
+ * 透過 Slack Webhook 發送威脅警報
+ *
+ * @param config - Slack webhook configuration / Slack webhook 配置
+ * @param verdict - The threat verdict / 威脅判決
+ * @param eventDescription - Event description / 事件描述
+ * @returns Notification result / 通知結果
+ */
+export declare function sendSlackNotify(config: SlackConfig, verdict: ThreatVerdict, eventDescription: string): Promise<NotificationResult>;
+//# sourceMappingURL=slack.d.ts.map

package/dist/notify/slack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack.d.ts","sourceRoot":"","sources":["../../src/notify/slack.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAIlF;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,aAAa,EACtB,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,kBAAkB,CAAC,CAoC7B"}

package/dist/notify/slack.js

@@ -0,0 +1,92 @@
+/**
+ * Slack Webhook notification integration
+ * Slack Webhook 通知整合
+ *
+ * Sends threat alerts to Slack channels via Incoming Webhooks.
+ * 透過 Incoming Webhooks 將威脅警報發送至 Slack 頻道。
+ *
+ * @module @panguard-ai/panguard-guard/notify/slack
+ */
+import { request } from 'node:https';
+import { createLogger } from '@panguard-ai/core';
+const logger = createLogger('panguard-guard:notify:slack');
+/**
+ * Send a threat alert via Slack Webhook
+ * 透過 Slack Webhook 發送威脅警報
+ *
+ * @param config - Slack webhook configuration / Slack webhook 配置
+ * @param verdict - The threat verdict / 威脅判決
+ * @param eventDescription - Event description / 事件描述
+ * @returns Notification result / 通知結果
+ */
+export async function sendSlackNotify(config, verdict, eventDescription) {
+    const color = verdict.conclusion === 'malicious'
+        ? '#dc3545'
+        : verdict.conclusion === 'suspicious'
+            ? '#ffc107'
+            : '#28a745';
+    const payload = {
+        attachments: [
+            {
+                color,
+                title: `PanguardGuard Alert: ${verdict.conclusion.toUpperCase()}`,
+                fields: [
+                    { title: 'Confidence', value: `${verdict.confidence}%`, short: true },
+                    { title: 'Action', value: verdict.recommendedAction, short: true },
+                    { title: 'Event', value: eventDescription, short: false },
+                    ...(verdict.mitreTechnique
+                        ? [{ title: 'MITRE ATT&CK', value: verdict.mitreTechnique, short: true }]
+                        : []),
+                ],
+                footer: 'PanguardGuard Security',
+                ts: Math.floor(Date.now() / 1000).toString(),
+            },
+        ],
+    };
+    try {
+        await postSlack(config.webhookUrl, payload);
+        logger.info('Slack notification sent / Slack 通知已發送');
+        return { channel: 'slack', success: true };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        logger.error(`Slack notification failed: ${msg} / Slack 通知失敗: ${msg}`);
+        return { channel: 'slack', success: false, error: msg };
+    }
+}
+/**
+ * POST to Slack Webhook URL / 向 Slack Webhook URL 發送 POST
+ */
+function postSlack(webhookUrl, payload) {
+    return new Promise((resolve, reject) => {
+        const body = JSON.stringify(payload);
+        const url = new URL(webhookUrl);
+        const req = request({
+            hostname: url.hostname,
+            port: 443,
+            path: url.pathname,
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Content-Length': Buffer.byteLength(body),
+            },
+        }, (res) => {
+            let data = '';
+            res.on('data', (chunk) => {
+                data += chunk.toString();
+            });
+            res.on('end', () => {
+                if (res.statusCode === 200) {
+                    resolve();
+                }
+                else {
+                    reject(new Error(`Slack HTTP ${res.statusCode}: ${data}`));
+                }
+            });
+        });
+        req.on('error', reject);
+        req.write(body);
+        req.end();
+    });
+}
+//# sourceMappingURL=slack.js.map

package/dist/notify/slack.js.map

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

package/dist/notify/telegram.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Telegram Bot notification integration
+ * Telegram Bot 通知整合
+ *
+ * Sends threat alerts to Telegram chats via Bot API.
+ * 透過 Bot API 將威脅警報發送至 Telegram 聊天。
+ *
+ * @module @panguard-ai/panguard-guard/notify/telegram
+ */
+import type { TelegramConfig, NotificationResult, ThreatVerdict } from '../types.js';
+/**
+ * Send a threat alert via Telegram Bot
+ * 透過 Telegram Bot 發送威脅警報
+ *
+ * @param config - Telegram Bot configuration / Telegram Bot 配置
+ * @param verdict - The threat verdict / 威脅判決
+ * @param eventDescription - Event description / 事件描述
+ * @returns Notification result / 通知結果
+ */
+export declare function sendTelegramNotify(config: TelegramConfig, verdict: ThreatVerdict, eventDescription: string): Promise<NotificationResult>;
+//# sourceMappingURL=telegram.d.ts.map

package/dist/notify/telegram.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram.d.ts","sourceRoot":"","sources":["../../src/notify/telegram.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAIrF;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,aAAa,EACtB,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,kBAAkB,CAAC,CA0B7B"}

package/dist/notify/telegram.js

@@ -0,0 +1,89 @@
+/**
+ * Telegram Bot notification integration
+ * Telegram Bot 通知整合
+ *
+ * Sends threat alerts to Telegram chats via Bot API.
+ * 透過 Bot API 將威脅警報發送至 Telegram 聊天。
+ *
+ * @module @panguard-ai/panguard-guard/notify/telegram
+ */
+import { request } from 'node:https';
+import { createLogger } from '@panguard-ai/core';
+const logger = createLogger('panguard-guard:notify:telegram');
+/**
+ * Send a threat alert via Telegram Bot
+ * 透過 Telegram Bot 發送威脅警報
+ *
+ * @param config - Telegram Bot configuration / Telegram Bot 配置
+ * @param verdict - The threat verdict / 威脅判決
+ * @param eventDescription - Event description / 事件描述
+ * @returns Notification result / 通知結果
+ */
+export async function sendTelegramNotify(config, verdict, eventDescription) {
+    const conclusionLabel = verdict.conclusion === 'malicious'
+        ? 'MALICIOUS'
+        : verdict.conclusion === 'suspicious'
+            ? 'SUSPICIOUS'
+            : 'BENIGN';
+    const text = `*[PanguardGuard Alert]*\n\n` +
+        `*Conclusion:* ${conclusionLabel}\n` +
+        `*Confidence:* ${verdict.confidence}%\n` +
+        `*Action:* ${verdict.recommendedAction}\n` +
+        `*Event:* ${escapeMarkdown(eventDescription)}\n` +
+        `${verdict.mitreTechnique ? `*MITRE:* ${verdict.mitreTechnique}\n` : ''}` +
+        `*Time:* ${new Date().toISOString()}`;
+    try {
+        await postTelegram(config.botToken, config.chatId, text);
+        logger.info('Telegram notification sent / Telegram 通知已發送');
+        return { channel: 'telegram', success: true };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        logger.error(`Telegram notification failed: ${msg} / Telegram 通知失敗: ${msg}`);
+        return { channel: 'telegram', success: false, error: msg };
+    }
+}
+/**
+ * POST to Telegram Bot API sendMessage
+ * 向 Telegram Bot API sendMessage 發送 POST
+ */
+function postTelegram(botToken, chatId, text) {
+    return new Promise((resolve, reject) => {
+        const payload = JSON.stringify({
+            chat_id: chatId,
+            text,
+            parse_mode: 'Markdown',
+        });
+        const req = request({
+            hostname: 'api.telegram.org',
+            port: 443,
+            path: `/bot${botToken}/sendMessage`,
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Content-Length': Buffer.byteLength(payload),
+            },
+        }, (res) => {
+            let data = '';
+            res.on('data', (chunk) => {
+                data += chunk.toString();
+            });
+            res.on('end', () => {
+                if (res.statusCode === 200) {
+                    resolve();
+                }
+                else {
+                    reject(new Error(`Telegram HTTP ${res.statusCode}: ${data}`));
+                }
+            });
+        });
+        req.on('error', reject);
+        req.write(payload);
+        req.end();
+    });
+}
+/** Escape Markdown special characters / 逸出 Markdown 特殊字元 */
+function escapeMarkdown(text) {
+    return text.replace(/[_*[\]()~`>#+\-=|{}.!]/g, '\\$&');
+}
+//# sourceMappingURL=telegram.js.map

package/dist/notify/telegram.js.map

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

package/dist/response/file-quarantine.d.ts

@@ -0,0 +1,63 @@
+/**
+ * File Quarantine - Isolate suspicious files with metadata and restore
+ * 檔案隔離 - 隔離可疑檔案（含中繼資料與還原功能）
+ *
+ * Features:
+ * - Move files to quarantine directory with restricted permissions
+ * - SHA-256 hash recording for evidence
+ * - Quarantine manifest (JSON) for tracking
+ * - Restore functionality to return files to original location
+ *
+ * @module @panguard-ai/panguard-guard/response/file-quarantine
+ */
+/** Quarantine record for a single file / 單一檔案的隔離紀錄 */
+export interface QuarantineRecord {
+    id: string;
+    originalPath: string;
+    quarantinePath: string;
+    sha256: string;
+    fileSize: number;
+    reason: string;
+    quarantinedAt: string;
+    restoredAt?: string;
+}
+/** Quarantine manifest stored as JSON / 隔離清單（JSON 格式） */
+export interface QuarantineManifest {
+    version: 1;
+    records: QuarantineRecord[];
+}
+/**
+ * Manages file quarantine with metadata tracking and restore
+ * 管理檔案隔離（含中繼資料追蹤與還原功能）
+ */
+export declare class FileQuarantine {
+    private readonly quarantineDir;
+    private readonly manifestPath;
+    private manifest;
+    constructor(quarantineDir?: string);
+    /** Initialize quarantine directory / 初始化隔離目錄 */
+    initialize(): Promise<void>;
+    /**
+     * Quarantine a file
+     * 隔離檔案
+     */
+    quarantine(filePath: string, reason: string): Promise<QuarantineRecord>;
+    /**
+     * Restore a quarantined file to its original location
+     * 還原隔離檔案到原始位置
+     */
+    restore(id: string): Promise<{
+        success: boolean;
+        message: string;
+    }>;
+    /** Get all quarantine records / 取得所有隔離紀錄 */
+    getRecords(): QuarantineRecord[];
+    /** Get active (not restored) quarantine records / 取得未還原的隔離紀錄 */
+    getActiveRecords(): QuarantineRecord[];
+    /** Find record by ID / 以 ID 搜尋紀錄 */
+    findRecord(id: string): QuarantineRecord | undefined;
+    /** Count files in quarantine / 隔離區檔案數量 */
+    getQuarantineCount(): Promise<number>;
+    private saveManifest;
+}
+//# sourceMappingURL=file-quarantine.d.ts.map

package/dist/response/file-quarantine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-quarantine.d.ts","sourceRoot":"","sources":["../../src/response/file-quarantine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAUH,sDAAsD;AACtD,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,yDAAyD;AACzD,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,CAAC,CAAC;IACX,OAAO,EAAE,gBAAgB,EAAE,CAAC;CAC7B;AAED;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAmD;gBAEvD,aAAa,CAAC,EAAE,MAAM;IAKlC,gDAAgD;IAC1C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAWjC;;;OAGG;IACG,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA+C7E;;;OAGG;IACG,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IA8BzE,4CAA4C;IAC5C,UAAU,IAAI,gBAAgB,EAAE;IAIhC,gEAAgE;IAChE,gBAAgB,IAAI,gBAAgB,EAAE;IAItC,oCAAoC;IACpC,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAIpD,0CAA0C;IACpC,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC;YAS7B,YAAY;CAG3B"}