clawsec 0.0.1

package/dist/src/notifications/telegram.js

@@ -0,0 +1,242 @@
+/**
+ * Telegram Notification Integration
+ * Sends security event notifications to Telegram via Bot API
+ */
+/**
+ * Severity emoji for Telegram
+ */
+const SEVERITY_EMOJI = {
+    critical: '🚨',
+    high: '⚠️',
+    medium: '🟡',
+    low: 'ℹ️',
+};
+/**
+ * Escape special characters for Telegram MarkdownV2
+ */
+function escapeMarkdownV2(text) {
+    return text.replace(/[_*\[\]()~`>#+=|{}.!-]/g, '\\$&');
+}
+/**
+ * Escape special characters for Telegram HTML
+ */
+function escapeHtml(text) {
+    return text
+        .replace(/&/g, '&')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;');
+}
+/**
+ * Format a security event as a Telegram message (HTML format)
+ */
+function formatTelegramMessageHtml(event) {
+    const emoji = SEVERITY_EMOJI[event.severity];
+    const timestamp = new Date(event.timestamp).toISOString();
+    return `${emoji} <b>Security Alert: ${escapeHtml(event.category.toUpperCase())}</b>
+
+<b>Reason:</b> ${escapeHtml(event.reason)}
+
+<b>Details:</b>
+• Severity: ${escapeHtml(event.severity.toUpperCase())}
+• Action: ${escapeHtml(event.action.toUpperCase())}
+• Tool: ${escapeHtml(event.toolName)}
+• Event ID: <code>${escapeHtml(event.eventId)}</code>
+${event.sessionId ? `• Session: <code>${escapeHtml(event.sessionId.substring(0, 8))}...</code>` : ''}
+
+<i>Clawsec Security Plugin • ${escapeHtml(timestamp)}</i>`;
+}
+/**
+ * Format a security event as a Telegram message (Markdown format)
+ */
+function formatTelegramMessageMarkdown(event) {
+    const emoji = SEVERITY_EMOJI[event.severity];
+    const timestamp = new Date(event.timestamp).toISOString();
+    return `${emoji} *Security Alert: ${event.category.toUpperCase()}*
+
+*Reason:* ${event.reason}
+
+*Details:*
+• Severity: ${event.severity.toUpperCase()}
+• Action: ${event.action.toUpperCase()}
+• Tool: ${event.toolName}
+• Event ID: \`${event.eventId}\`
+${event.sessionId ? `• Session: \`${event.sessionId.substring(0, 8)}...\`` : ''}
+
+_Clawsec Security Plugin • ${timestamp}_`;
+}
+/**
+ * Format a security event as a Telegram message (MarkdownV2 format)
+ */
+function formatTelegramMessageMarkdownV2(event) {
+    const emoji = SEVERITY_EMOJI[event.severity];
+    const timestamp = new Date(event.timestamp).toISOString();
+    return `${emoji} *Security Alert: ${escapeMarkdownV2(event.category.toUpperCase())}*
+
+*Reason:* ${escapeMarkdownV2(event.reason)}
+
+*Details:*
+• Severity: ${escapeMarkdownV2(event.severity.toUpperCase())}
+• Action: ${escapeMarkdownV2(event.action.toUpperCase())}
+• Tool: ${escapeMarkdownV2(event.toolName)}
+• Event ID: \`${escapeMarkdownV2(event.eventId)}\`
+${event.sessionId ? `• Session: \`${escapeMarkdownV2(event.sessionId.substring(0, 8))}\\.\\.\\.\`` : ''}
+
+_Clawsec Security Plugin • ${escapeMarkdownV2(timestamp)}_`;
+}
+/**
+ * Format a security event as a Telegram message
+ */
+function formatTelegramMessage(event, parseMode) {
+    switch (parseMode) {
+        case 'HTML':
+            return formatTelegramMessageHtml(event);
+        case 'MarkdownV2':
+            return formatTelegramMessageMarkdownV2(event);
+        case 'Markdown':
+        default:
+            return formatTelegramMessageMarkdown(event);
+    }
+}
+/**
+ * Format a test message for Telegram
+ */
+function formatTestMessage(parseMode) {
+    switch (parseMode) {
+        case 'HTML':
+            return '✅ <b>Clawsec Test Notification</b>\n\nYour Telegram integration is working correctly.\n\n<i>Clawsec Security Plugin</i>';
+        case 'MarkdownV2':
+            return '✅ *Clawsec Test Notification*\n\nYour Telegram integration is working correctly\\.\n\n_Clawsec Security Plugin_';
+        case 'Markdown':
+        default:
+            return '✅ *Clawsec Test Notification*\n\nYour Telegram integration is working correctly.\n\n_Clawsec Security Plugin_';
+    }
+}
+/**
+ * Check if event should trigger notification based on config
+ */
+function shouldNotify(event, config) {
+    // Check minimum severity
+    if (config.minSeverity) {
+        const severityOrder = ['low', 'medium', 'high', 'critical'];
+        const minIndex = severityOrder.indexOf(config.minSeverity);
+        const eventIndex = severityOrder.indexOf(event.severity);
+        if (eventIndex < minIndex) {
+            return false;
+        }
+    }
+    // Check category filter
+    if (config.categories && config.categories.length > 0) {
+        if (!config.categories.includes(event.category)) {
+            return false;
+        }
+    }
+    return true;
+}
+/**
+ * Create a Telegram notification sender
+ */
+export function createTelegramSender(config) {
+    const baseUrl = `https://api.telegram.org/bot${config.botToken}`;
+    return {
+        async send(event) {
+            if (!config.enabled) {
+                return {
+                    success: false,
+                    channel: 'telegram',
+                    error: 'Telegram notifications are disabled',
+                };
+            }
+            if (!shouldNotify(event, config)) {
+                return {
+                    success: true,
+                    channel: 'telegram',
+                    response: 'Skipped due to filter settings',
+                };
+            }
+            try {
+                const text = formatTelegramMessage(event, config.parseMode);
+                const payload = {
+                    chat_id: config.chatId,
+                    text,
+                };
+                if (config.parseMode) {
+                    payload.parse_mode = config.parseMode;
+                }
+                const response = await fetch(`${baseUrl}/sendMessage`, {
+                    method: 'POST',
+                    headers: {
+                        'Content-Type': 'application/json',
+                    },
+                    body: JSON.stringify(payload),
+                });
+                const result = await response.json();
+                if (!result.ok) {
+                    return {
+                        success: false,
+                        channel: 'telegram',
+                        error: `Telegram API error: ${result.description || 'Unknown error'}`,
+                    };
+                }
+                return {
+                    success: true,
+                    channel: 'telegram',
+                    response: result,
+                };
+            }
+            catch (error) {
+                return {
+                    success: false,
+                    channel: 'telegram',
+                    error: error instanceof Error ? error.message : 'Unknown error',
+                };
+            }
+        },
+        async test() {
+            if (!config.enabled) {
+                return {
+                    success: false,
+                    channel: 'telegram',
+                    error: 'Telegram notifications are disabled',
+                };
+            }
+            try {
+                const text = formatTestMessage(config.parseMode);
+                const payload = {
+                    chat_id: config.chatId,
+                    text,
+                };
+                if (config.parseMode) {
+                    payload.parse_mode = config.parseMode;
+                }
+                const response = await fetch(`${baseUrl}/sendMessage`, {
+                    method: 'POST',
+                    headers: {
+                        'Content-Type': 'application/json',
+                    },
+                    body: JSON.stringify(payload),
+                });
+                const result = await response.json();
+                if (!result.ok) {
+                    return {
+                        success: false,
+                        channel: 'telegram',
+                        error: `Telegram API error: ${result.description || 'Unknown error'}`,
+                    };
+                }
+                return {
+                    success: true,
+                    channel: 'telegram',
+                    response: 'Test message sent successfully',
+                };
+            }
+            catch (error) {
+                return {
+                    success: false,
+                    channel: 'telegram',
+                    error: error instanceof Error ? error.message : 'Unknown error',
+                };
+            }
+        },
+    };
+}
+//# sourceMappingURL=telegram.js.map

package/dist/src/notifications/telegram.js.map

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

package/dist/src/notifications/types.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Notification Types
+ * Type definitions for the notification system
+ */
+/**
+ * Severity levels for security detections
+ */
+export type Severity = 'critical' | 'high' | 'medium' | 'low';
+/**
+ * Categories of security threats
+ */
+export type ThreatCategory = 'purchase' | 'website' | 'destructive' | 'secrets' | 'exfiltration';
+/**
+ * Supported notification channels
+ */
+export type NotificationChannel = 'slack' | 'discord' | 'telegram';
+/**
+ * Security event notification payload
+ */
+export interface SecurityEventPayload {
+    /** Unique event ID */
+    eventId: string;
+    /** Event timestamp */
+    timestamp: number;
+    /** Threat category */
+    category: ThreatCategory;
+    /** Severity level */
+    severity: Severity;
+    /** Tool that triggered the event */
+    toolName: string;
+    /** Brief description of the threat */
+    reason: string;
+    /** Action taken */
+    action: 'blocked' | 'confirmed' | 'warned' | 'logged';
+    /** Session ID */
+    sessionId?: string;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Notification result
+ */
+export interface NotificationResult {
+    /** Whether the notification was sent successfully */
+    success: boolean;
+    /** Channel used */
+    channel: NotificationChannel;
+    /** Error message if failed */
+    error?: string;
+    /** Response from the notification service */
+    response?: unknown;
+}
+/**
+ * Base notification configuration
+ */
+export interface BaseNotificationConfig {
+    /** Whether this notification channel is enabled */
+    enabled: boolean;
+    /** Minimum severity to trigger notification */
+    minSeverity?: Severity;
+    /** Categories to notify for (empty = all) */
+    categories?: ThreatCategory[];
+}
+/**
+ * Slack notification configuration
+ */
+export interface SlackConfig extends BaseNotificationConfig {
+    /** Slack webhook URL */
+    webhookUrl: string;
+    /** Channel to post to (optional, uses webhook default) */
+    channel?: string;
+    /** Username for the bot */
+    username?: string;
+    /** Icon emoji for the bot */
+    iconEmoji?: string;
+}
+/**
+ * Discord notification configuration
+ */
+export interface DiscordConfig extends BaseNotificationConfig {
+    /** Discord webhook URL */
+    webhookUrl: string;
+    /** Username for the bot */
+    username?: string;
+    /** Avatar URL for the bot */
+    avatarUrl?: string;
+}
+/**
+ * Telegram notification configuration
+ */
+export interface TelegramConfig extends BaseNotificationConfig {
+    /** Telegram bot token */
+    botToken: string;
+    /** Chat ID to send messages to */
+    chatId: string;
+    /** Parse mode for messages */
+    parseMode?: 'HTML' | 'Markdown' | 'MarkdownV2';
+}
+/**
+ * Complete notification configuration
+ */
+export interface NotificationConfig {
+    /** Slack configuration */
+    slack?: SlackConfig;
+    /** Discord configuration */
+    discord?: DiscordConfig;
+    /** Telegram configuration */
+    telegram?: TelegramConfig;
+}
+/**
+ * Notification sender interface
+ */
+export interface NotificationSender {
+    /** Send a security event notification */
+    send(event: SecurityEventPayload): Promise<NotificationResult>;
+    /** Test the notification configuration */
+    test(): Promise<NotificationResult>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/notifications/types.d.ts.map

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

package/dist/src/notifications/types.js

@@ -0,0 +1,6 @@
+/**
+ * Notification Types
+ * Type definitions for the notification system
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/notifications/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/notifications/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/src/proxy/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Standalone Proxy Server Module
+ * HTTP proxy server for tool call analysis without OpenClaw integration
+ */
+export type { ProxyConfig, ProxyRequest, ProxyResponse, ApprovalActionResponse, StatusResponse, HealthResponse, ErrorResponse, ProxyServer, RequestHandler, ProxyHttpRequest, ProxyHttpResponse, } from './types.js';
+export { toToolCallContext, toProxyResponse, AnalysisMiddleware, ValidationError, createAnalysisMiddleware, } from './middleware.js';
+export { HttpProxyServer, createProxyServer, } from './server.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/proxy/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/proxy/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,YAAY,EACV,WAAW,EACX,YAAY,EACZ,aAAa,EACb,sBAAsB,EACtB,cAAc,EACd,cAAc,EACd,aAAa,EACb,WAAW,EACX,cAAc,EACd,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,wBAAwB,GACzB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,eAAe,EACf,iBAAiB,GAClB,MAAM,aAAa,CAAC"}

package/dist/src/proxy/index.js

@@ -0,0 +1,9 @@
+/**
+ * Standalone Proxy Server Module
+ * HTTP proxy server for tool call analysis without OpenClaw integration
+ */
+// Middleware
+export { toToolCallContext, toProxyResponse, AnalysisMiddleware, ValidationError, createAnalysisMiddleware, } from './middleware.js';
+// Server
+export { HttpProxyServer, createProxyServer, } from './server.js';
+//# sourceMappingURL=index.js.map

package/dist/src/proxy/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/proxy/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAiBH,aAAa;AACb,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,wBAAwB,GACzB,MAAM,iBAAiB,CAAC;AAEzB,SAAS;AACT,OAAO,EACL,eAAe,EACf,iBAAiB,GAClB,MAAM,aAAa,CAAC"}

package/dist/src/proxy/middleware.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Proxy Middleware
+ * Request processing middleware that bridges HTTP requests to the detection engine
+ */
+import type { ToolCallContext, AnalysisResult, Analyzer } from '../engine/types.js';
+import type { ApprovalStore } from '../approval/types.js';
+import type { ProxyRequest, ProxyResponse, ApprovalActionResponse, StatusResponse, HealthResponse, ProxyConfig } from './types.js';
+/**
+ * Convert ProxyRequest to ToolCallContext for analysis
+ */
+export declare function toToolCallContext(request: ProxyRequest): ToolCallContext;
+/**
+ * Convert AnalysisResult to ProxyResponse
+ */
+export declare function toProxyResponse(result: AnalysisResult, pendingApprovalId?: string, approvalTimeoutSeconds?: number): ProxyResponse;
+/**
+ * Middleware for processing analysis requests
+ */
+export declare class AnalysisMiddleware {
+    private readonly analyzer;
+    private readonly approvalStore;
+    private readonly approvalTimeoutSeconds;
+    constructor(analyzer: Analyzer, approvalStore: ApprovalStore, approvalTimeoutSeconds?: number);
+    /**
+     * Process an analysis request
+     */
+    analyze(request: Record<string, unknown>): Promise<ProxyResponse>;
+    /**
+     * Approve a pending request
+     */
+    approve(id: string, approvedBy?: string): ApprovalActionResponse;
+    /**
+     * Deny a pending request
+     */
+    deny(id: string): ApprovalActionResponse;
+    /**
+     * Get server status
+     */
+    getStatus(config: ProxyConfig, actualPort?: number): StatusResponse;
+    /**
+     * Get health status
+     */
+    getHealth(): HealthResponse;
+}
+/**
+ * Custom error for validation failures
+ */
+export declare class ValidationError extends Error {
+    constructor(message: string);
+}
+/**
+ * Create an analysis middleware instance
+ */
+export declare function createAnalysisMiddleware(analyzer: Analyzer, approvalStore: ApprovalStore, approvalTimeoutSeconds?: number): AnalysisMiddleware;
+//# sourceMappingURL=middleware.d.ts.map

package/dist/src/proxy/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../../src/proxy/middleware.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACpF,OAAO,KAAK,EACV,aAAa,EAEd,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EACb,sBAAsB,EACtB,cAAc,EACd,cAAc,EACd,WAAW,EACZ,MAAM,YAAY,CAAC;AAcpB;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,YAAY,GAAG,eAAe,CAYxE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,cAAc,EACtB,iBAAiB,CAAC,EAAE,MAAM,EAC1B,sBAAsB,CAAC,EAAE,MAAM,GAC9B,aAAa,CA4Cf;AAED;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;IACpC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAS;gBAG9C,QAAQ,EAAE,QAAQ,EAClB,aAAa,EAAE,aAAa,EAC5B,sBAAsB,GAAE,MAAyC;IAOnE;;OAEG;IACG,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC;IA8CvE;;OAEG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,sBAAsB;IA0BhE;;OAEG;IACH,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,sBAAsB;IA0BxC;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,WAAW,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,cAAc;IAanE;;OAEG;IACH,SAAS,IAAI,cAAc;CAG5B;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,KAAK;gBAC5B,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,QAAQ,EAClB,aAAa,EAAE,aAAa,EAC5B,sBAAsB,CAAC,EAAE,MAAM,GAC9B,kBAAkB,CAEpB"}