@dcyfr/ai 2.1.3 → 3.0.0

package/dist/ai/src/gateway/message-gateway.d.ts

@@ -0,0 +1,296 @@
+/**
+ * DCYFR Messaging Gateway
+ * TLP:AMBER - Internal Use Only
+ *
+ * Provides a platform-agnostic messaging interface for autonomous agents.
+ * Features:
+ *   - Platform adapter pattern (Telegram, Slack, Discord, HTTP, CLI)
+ *   - Input sanitization (prompt injection detection, Unicode direction override blocking)
+ *   - Trust-level assignment based on platform and user authentication
+ *   - Outbound message formatting with platform-specific rendering
+ *   - Telemetry integration (message.received, message.sent, message.blocked)
+ *   - Rate limiting per user/platform
+ *
+ * @module gateway/message-gateway
+ * @version 1.0.0
+ * @date 2026-03-01
+ */
+import { EventEmitter } from 'node:events';
+/** Supported platforms */
+export type GatewayPlatform = 'telegram' | 'slack' | 'discord' | 'http' | 'cli' | string;
+/** Trust level assigned to inbound messages */
+export type GatewayTrustLevel = 'full' | 'sandboxed' | 'readonly';
+/**
+ * Inbound message from a platform
+ */
+export interface InboundMessage {
+    /** Unique message ID (from platform or auto-generated) */
+    id: string;
+    /** Platform the message originates from */
+    platform: GatewayPlatform;
+    /** User ID on the platform */
+    userId: string;
+    /** User display name (if available) */
+    userName?: string;
+    /** Chat/channel ID */
+    chatId: string;
+    /** Raw message text */
+    text: string;
+    /** Timestamp */
+    timestamp: Date;
+    /** Platform-specific raw payload */
+    rawPayload?: unknown;
+    /** Attachments (file URLs, images, etc.) */
+    attachments?: MessageAttachment[];
+    /** Metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Message attachment
+ */
+export interface MessageAttachment {
+    /** Attachment type */
+    type: 'image' | 'file' | 'audio' | 'video' | 'document';
+    /** URL or base64 data */
+    url: string;
+    /** MIME type */
+    mimeType?: string;
+    /** File name */
+    fileName?: string;
+    /** Size in bytes */
+    sizeBytes?: number;
+}
+/**
+ * Processed inbound message — after sanitization and enrichment
+ */
+export interface ProcessedMessage {
+    /** Original inbound message */
+    original: InboundMessage;
+    /** Sanitized text (safe to pass to LLM) */
+    sanitizedText: string;
+    /** Assigned trust level */
+    trustLevel: GatewayTrustLevel;
+    /** Session ID (created or resumed) */
+    sessionId?: string;
+    /** Whether the message was flagged by sanitization */
+    flagged: boolean;
+    /** Sanitization warnings (if any) */
+    warnings: string[];
+    /** Processing timestamp */
+    processedAt: Date;
+}
+/**
+ * Outbound message to send to a platform
+ */
+export interface OutboundMessage {
+    /** Platform to send to */
+    platform: GatewayPlatform;
+    /** Chat/channel ID */
+    chatId: string;
+    /** Message text (Markdown) */
+    text: string;
+    /** Reply to message ID (if applicable) */
+    replyToId?: string;
+    /** Parse mode */
+    parseMode?: 'markdown' | 'html' | 'plain';
+    /** Metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Result of sending an outbound message
+ */
+export interface SendResult {
+    /** Whether the send was successful */
+    success: boolean;
+    /** Platform-assigned message ID */
+    messageId?: string;
+    /** Error message if failed */
+    error?: string;
+}
+/**
+ * Platform adapter interface — implement for each messaging platform
+ */
+export interface PlatformAdapter {
+    /** Platform name */
+    readonly platform: GatewayPlatform;
+    /** Send a message to the platform */
+    send(message: OutboundMessage): Promise<SendResult>;
+    /** Format text for the platform's rendering engine */
+    formatText(markdown: string): string;
+    /** Platform-specific message validation */
+    validate(message: InboundMessage): boolean;
+}
+/**
+ * Trust assignment rule — maps platform/user criteria to trust levels
+ */
+export interface TrustRule {
+    /** Rule name */
+    name: string;
+    /** Platform filter (null = all platforms) */
+    platform?: GatewayPlatform;
+    /** User IDs that match this rule */
+    userIds?: string[];
+    /** Trust level to assign */
+    trustLevel: GatewayTrustLevel;
+    /** Priority (higher = checked first) */
+    priority: number;
+}
+/**
+ * Sanitization result
+ */
+export interface SanitizationResult {
+    /** Sanitized text */
+    text: string;
+    /** Whether any issues were found */
+    flagged: boolean;
+    /** Warning messages */
+    warnings: string[];
+    /** Whether the message was blocked entirely */
+    blocked: boolean;
+    /** Block reason (if blocked) */
+    blockReason?: string;
+}
+/**
+ * Gateway telemetry event
+ */
+export interface GatewayTelemetryEvent {
+    type: 'message.received' | 'message.sent' | 'message.blocked' | 'message.sanitized' | 'message.rate_limited';
+    data: Record<string, unknown>;
+    timestamp: Date;
+}
+/**
+ * Sanitize inbound message text
+ */
+export declare function sanitizeInput(text: string): SanitizationResult;
+/**
+ * Telegram Platform Adapter
+ *
+ * Formats messages for Telegram's MarkdownV2 syntax.
+ * In a real implementation, this would use the Telegram Bot API.
+ */
+export declare class TelegramAdapter implements PlatformAdapter {
+    readonly platform: GatewayPlatform;
+    private readonly sendFn?;
+    constructor(options?: {
+        sendFn?: (message: OutboundMessage) => Promise<SendResult>;
+    });
+    send(message: OutboundMessage): Promise<SendResult>;
+    formatText(markdown: string): string;
+    validate(message: InboundMessage): boolean;
+}
+/**
+ * CLI Platform Adapter — for local development and testing
+ */
+export declare class CLIAdapter implements PlatformAdapter {
+    readonly platform: GatewayPlatform;
+    readonly messages: OutboundMessage[];
+    send(message: OutboundMessage): Promise<SendResult>;
+    formatText(markdown: string): string;
+    validate(_message: InboundMessage): boolean;
+}
+/**
+ * HTTP Webhook Platform Adapter — for generic HTTP integrations
+ */
+export declare class HTTPAdapter implements PlatformAdapter {
+    readonly platform: GatewayPlatform;
+    private readonly sendFn?;
+    constructor(options?: {
+        sendFn?: (message: OutboundMessage) => Promise<SendResult>;
+    });
+    send(message: OutboundMessage): Promise<SendResult>;
+    formatText(markdown: string): string;
+    validate(message: InboundMessage): boolean;
+}
+/**
+ * Configuration for MessageGateway
+ */
+export interface MessageGatewayConfig {
+    /** Platform adapters */
+    adapters?: PlatformAdapter[];
+    /** Trust assignment rules (sorted by priority) */
+    trustRules?: TrustRule[];
+    /** Default trust level for unmatched messages */
+    defaultTrustLevel?: GatewayTrustLevel;
+    /** Rate limit: max messages per user per window */
+    rateLimitMaxMessages?: number;
+    /** Rate limit: window size in ms */
+    rateLimitWindowMs?: number;
+}
+/**
+ * Message Gateway
+ *
+ * Platform-agnostic messaging interface for autonomous agents.
+ * Handles inbound message reception and sanitization, trust-level assignment,
+ * outbound message sending, and telemetry.
+ *
+ * Emits:
+ *   - `message.received` — Inbound message processed
+ *   - `message.sent` — Outbound message sent successfully
+ *   - `message.blocked` — Message blocked by sanitization
+ *   - `message.sanitized` — Message had sanitization warnings
+ *   - `message.rate_limited` — Message rate-limited
+ */
+export declare class MessageGateway extends EventEmitter {
+    private readonly adapters;
+    private readonly trustRules;
+    private readonly defaultTrustLevel;
+    private readonly rateLimitMaxMessages;
+    private readonly rateLimitWindowMs;
+    private readonly rateLimits;
+    constructor(config?: MessageGatewayConfig);
+    /**
+     * Register a platform adapter
+     */
+    registerAdapter(adapter: PlatformAdapter): void;
+    /**
+     * Get a registered adapter
+     */
+    getAdapter(platform: GatewayPlatform): PlatformAdapter | undefined;
+    /**
+     * List all registered platform names
+     */
+    getPlatforms(): GatewayPlatform[];
+    /**
+     * Process an inbound message:
+     * 1. Validate via platform adapter
+     * 2. Check rate limits
+     * 3. Sanitize input
+     * 4. Assign trust level
+     * 5. Return processed message
+     *
+     * @throws Error if platform adapter is not registered
+     */
+    processInbound(message: InboundMessage): Promise<ProcessedMessage>;
+    /**
+     * Send a message to a platform
+     *
+     * @throws Error if platform adapter is not registered
+     */
+    send(message: OutboundMessage): Promise<SendResult>;
+    /**
+     * Send a reply to a specific message
+     */
+    reply(originalMessage: InboundMessage, text: string, parseMode?: 'markdown' | 'html' | 'plain'): Promise<SendResult>;
+    /**
+     * Add a trust rule
+     */
+    addTrustRule(rule: TrustRule): void;
+    /**
+     * Assign trust level based on rules
+     */
+    private _assignTrustLevel;
+    /**
+     * Check if a user is rate-limited
+     */
+    private _isRateLimited;
+    private _telemetryEvent;
+    /**
+     * Clear rate limit state
+     */
+    clearRateLimits(): void;
+    /**
+     * Dispose of all resources
+     */
+    dispose(): void;
+}
+//# sourceMappingURL=message-gateway.d.ts.map

package/dist/ai/src/gateway/message-gateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-gateway.d.ts","sourceRoot":"","sources":["../../../../packages/ai/src/gateway/message-gateway.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAO3C,0BAA0B;AAC1B,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;AAEzF,+CAA+C;AAC/C,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,WAAW,GAAG,UAAU,CAAC;AAElE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,0DAA0D;IAC1D,EAAE,EAAE,MAAM,CAAC;IACX,2CAA2C;IAC3C,QAAQ,EAAE,eAAe,CAAC;IAC1B,8BAA8B;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,oCAAoC;IACpC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,4CAA4C;IAC5C,WAAW,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAClC,eAAe;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,sBAAsB;IACtB,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,CAAC;IACxD,yBAAyB;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,gBAAgB;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oBAAoB;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,+BAA+B;IAC/B,QAAQ,EAAE,cAAc,CAAC;IACzB,2CAA2C;IAC3C,aAAa,EAAE,MAAM,CAAC;IACtB,2BAA2B;IAC3B,UAAU,EAAE,iBAAiB,CAAC;IAC9B,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sDAAsD;IACtD,OAAO,EAAE,OAAO,CAAC;IACjB,qCAAqC;IACrC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,2BAA2B;IAC3B,WAAW,EAAE,IAAI,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,0BAA0B;IAC1B,QAAQ,EAAE,eAAe,CAAC;IAC1B,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB;IACjB,SAAS,CAAC,EAAE,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC;IAC1C,eAAe;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,sCAAsC;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,mCAAmC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,oBAAoB;IACpB,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IAEnC,qCAAqC;IACrC,IAAI,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAEpD,sDAAsD;IACtD,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;IAErC,2CAA2C;IAC3C,QAAQ,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC;CAC5C;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,4BAA4B;IAC5B,UAAU,EAAE,iBAAiB,CAAC;IAC9B,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,uBAAuB;IACvB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,+CAA+C;IAC/C,OAAO,EAAE,OAAO,CAAC;IACjB,gCAAgC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AASD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,kBAAkB,GAAG,cAAc,GAAG,iBAAiB,GAC3D,mBAAmB,GAAG,sBAAsB,CAAC;IAC/C,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,SAAS,EAAE,IAAI,CAAC;CACjB;AA0CD;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,CAsC9D;AAMD;;;;;GAKG;AACH,qBAAa,eAAgB,YAAW,eAAe;IACrD,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAc;IAChD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAoD;gBAEhE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,OAAO,CAAC,UAAU,CAAC,CAAA;KAAE;IAI9E,IAAI,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC;IAQzD,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAMpC,QAAQ,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO;CAG3C;AAED;;GAEG;AACH,qBAAa,UAAW,YAAW,eAAe;IAChD,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAS;IAC3C,QAAQ,CAAC,QAAQ,EAAE,eAAe,EAAE,CAAM;IAEpC,IAAI,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC;IAKzD,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAQpC,QAAQ,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO;CAG5C;AAED;;GAEG;AACH,qBAAa,WAAY,YAAW,eAAe;IACjD,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAU;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAoD;gBAEhE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,OAAO,CAAC,UAAU,CAAC,CAAA;KAAE;IAI9E,IAAI,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC;IAOzD,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAIpC,QAAQ,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO;CAG3C;AAMD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,wBAAwB;IACxB,QAAQ,CAAC,EAAE,eAAe,EAAE,CAAC;IAC7B,kDAAkD;IAClD,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC;IACzB,iDAAiD;IACjD,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,mDAAmD;IACnD,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,oCAAoC;IACpC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,cAAe,SAAQ,YAAY;IAC9C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA+C;IACxE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAc;IACzC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAoB;IACtD,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAS;IAC9C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqC;gBAEpD,MAAM,GAAE,oBAAyB;IAe7C;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IAI/C;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,eAAe,GAAG,eAAe,GAAG,SAAS;IAIlE;;OAEG;IACH,YAAY,IAAI,eAAe,EAAE;IAMjC;;;;;;;;;OASG;IACG,cAAc,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA2FxE;;;;OAIG;IACG,IAAI,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC;IA4BzD;;OAEG;IACG,KAAK,CACT,eAAe,EAAE,cAAc,EAC/B,IAAI,EAAE,MAAM,EACZ,SAAS,GAAE,UAAU,GAAG,MAAM,GAAG,OAAoB,GACpD,OAAO,CAAC,UAAU,CAAC;IAYtB;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAKnC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAczB;;OAEG;IACH,OAAO,CAAC,cAAc;IAwBtB,OAAO,CAAC,eAAe;IASvB;;OAEG;IACH,eAAe,IAAI,IAAI;IAIvB;;OAEG;IACH,OAAO,IAAI,IAAI;CAKhB"}