mach6-core 1.1.0

package/dist/channels/router.js

@@ -0,0 +1,244 @@
+/**
+ * Mach6 — Inbound Router
+ *
+ * Sits between channel adapters and the message bus.
+ * Handles: policy enforcement, session routing, priority assignment,
+ * deduplication, interrupt detection.
+ */
+import { randomUUID } from 'node:crypto';
+// ─── WhatsApp JID Normalization ────────────────────────────────────────────
+// Baileys v7 uses JIDs with device suffix: "1234567890:5@s.whatsapp.net"
+// Config stores them without suffix: "1234567890@s.whatsapp.net"
+// Normalize by stripping the device part before comparison.
+function normalizeJid(jid) {
+    // Strip device suffix from WhatsApp JIDs: "num:device@s.whatsapp.net" → "num@s.whatsapp.net"
+    return jid.replace(/:\d+@s\.whatsapp\.net$/, '@s.whatsapp.net');
+}
+function jidMatches(jid, target) {
+    return normalizeJid(jid) === normalizeJid(target);
+}
+function jidInList(jid, list) {
+    const normalized = normalizeJid(jid);
+    return list.some(item => normalizeJid(item) === normalized);
+}
+// ─── Interrupt Detection ───────────────────────────────────────────────────
+const INTERRUPT_PATTERNS = [
+    /^(stop|wait|hold on|pause|cancel|actually|never ?mind)/i,
+    /^(no[,.]?\s|don'?t\s|abort)/i,
+    /^(scratch that|forget it|hold up)/i,
+];
+// ─── Deduplication ─────────────────────────────────────────────────────────
+class DeduplicationCache {
+    seen = new Map(); // messageId → timestamp
+    maxSize;
+    ttlMs;
+    constructor(maxSize = 10_000, ttlMs = 5 * 60 * 1000) {
+        this.maxSize = maxSize;
+        this.ttlMs = ttlMs;
+    }
+    /** Returns true if this is a duplicate */
+    check(id) {
+        const now = Date.now();
+        this.evict(now);
+        if (this.seen.has(id))
+            return true;
+        this.seen.set(id, now);
+        return false;
+    }
+    evict(now) {
+        if (this.seen.size < this.maxSize)
+            return;
+        // Remove expired entries
+        for (const [id, ts] of this.seen) {
+            if (now - ts > this.ttlMs)
+                this.seen.delete(id);
+        }
+        // If still over, remove oldest
+        if (this.seen.size >= this.maxSize) {
+            const oldest = this.seen.keys().next().value;
+            if (oldest)
+                this.seen.delete(oldest);
+        }
+    }
+}
+export class InboundRouter {
+    bus;
+    config;
+    dedup = new DeduplicationCache();
+    routes = new Map(); // "channelType:chatId" → route
+    sessionCounter = 0;
+    constructor(bus, config) {
+        this.bus = bus;
+        this.config = config;
+    }
+    /**
+     * Route an inbound message from a channel adapter.
+     * Returns false if the message was rejected by policy.
+     */
+    route(source, payload, platformMessageId) {
+        // 1. Deduplication
+        const dedupKey = platformMessageId ?? `${source.adapterId}:${source.chatId}:${Date.now()}`;
+        if (this.dedup.check(dedupKey))
+            return false;
+        // 2. Policy check
+        const policy = this.getPolicy(source.channelType);
+        if (!this.checkPolicy(policy, source))
+            return false;
+        // 3. Resolve session
+        const sessionId = this.resolveSession(source);
+        // 4. Determine priority
+        const priority = this.assignPriority(policy, source, payload, sessionId);
+        // 5. Build envelope
+        const envelope = {
+            id: randomUUID(),
+            timestamp: Date.now(),
+            priority,
+            source,
+            sessionId,
+            payload,
+            metadata: {
+                platformMessageId,
+                guildId: source.guildId,
+            },
+        };
+        // 6. Publish to bus
+        this.bus.publish(envelope);
+        return true;
+    }
+    // ── Policy ─────────────────────────────────────────────────────────────
+    getPolicy(channelType) {
+        return this.config.policies.get(channelType) ?? this.config.defaultPolicy ?? {
+            dmPolicy: 'deny',
+            groupPolicy: 'deny',
+            ownerIds: [],
+        };
+    }
+    checkPolicy(policy, source) {
+        // Sibling bot yield: if message explicitly @mentions a sibling bot but NOT us, yield.
+        // This applies even for owners — ensures @Plug → only Plug, @AVA → only AVA.
+        // No mention at all → both respond (owner bypass or normal policy applies).
+        if (policy.siblingBotIds?.length && policy.selfId && source.mentions?.length) {
+            const mentionsMe = source.mentions.includes(policy.selfId);
+            const mentionsSibling = source.mentions.some(id => policy.siblingBotIds.includes(id));
+            if (mentionsSibling && !mentionsMe)
+                return false;
+        }
+        const isOwner = this.isOwner(policy, source.senderId);
+        if (isOwner)
+            return true; // Owners bypass all policy
+        if (source.chatType === 'dm') {
+            switch (policy.dmPolicy) {
+                case 'open': return true;
+                case 'allowlist': return jidInList(source.senderId, policy.allowedSenders ?? []);
+                case 'deny': return false;
+            }
+        }
+        if (source.chatType === 'group' || source.chatType === 'channel') {
+            switch (policy.groupPolicy) {
+                case 'open': return true;
+                case 'allowlist': return jidInList(source.chatId, policy.allowedGroups ?? []);
+                case 'mention-only': return this.isMentioned(policy, source);
+                case 'deny': return false;
+            }
+        }
+        // Threads inherit parent policy (treat as group)
+        if (source.chatType === 'thread') {
+            return policy.groupPolicy !== 'deny';
+        }
+        return false;
+    }
+    isOwner(policy, senderId) {
+        if (jidInList(senderId, policy.ownerIds))
+            return true;
+        if (this.config.globalOwnerIds && jidInList(senderId, this.config.globalOwnerIds))
+            return true;
+        return false;
+    }
+    isMentioned(policy, source) {
+        if (!policy.selfId || !source.mentions)
+            return false;
+        return source.mentions.includes(policy.selfId);
+    }
+    // ── Session Resolution ─────────────────────────────────────────────────
+    resolveSession(source) {
+        const routeKey = `${source.channelType}:${source.chatId}`;
+        const existing = this.routes.get(routeKey);
+        if (existing) {
+            existing.lastActive = Date.now();
+            return existing.sessionId;
+        }
+        // Create new session route
+        const sessionId = `${source.channelType}-${source.chatId}-${++this.sessionCounter}`;
+        this.routes.set(routeKey, {
+            channelType: source.channelType,
+            chatId: source.chatId,
+            sessionId,
+            lastActive: Date.now(),
+        });
+        return sessionId;
+    }
+    // ── Priority Assignment ────────────────────────────────────────────────
+    assignPriority(policy, source, payload, sessionId) {
+        // Non-text payloads
+        if (payload.type === 'typing' || payload.type === 'presence')
+            return 'background';
+        if (payload.type === 'reaction')
+            return 'low';
+        const isOwner = this.isOwner(policy, source.senderId);
+        const text = payload.text?.trim() ?? '';
+        // Check if this session has an active agent turn
+        const activeSessions = this.config.getActiveSessions?.() ?? new Set();
+        const sessionActive = activeSessions.has(sessionId);
+        // Owner message during active turn → interrupt
+        if (isOwner && sessionActive) {
+            // Check for explicit interrupt patterns
+            if (INTERRUPT_PATTERNS.some(p => p.test(text))) {
+                return 'interrupt';
+            }
+            // Owner sending anything during active turn is at least high priority
+            // The bus coalesce logic will handle rapid-fire messages
+            return 'high';
+        }
+        // Owner message (no active turn) → high
+        if (isOwner)
+            return 'high';
+        // DM from non-owner → normal
+        if (source.chatType === 'dm')
+            return 'normal';
+        // Group mention → normal
+        if (source.chatType === 'group' && this.isMentioned(policy, source))
+            return 'normal';
+        // Group without mention → low
+        return 'low';
+    }
+    // ── Route Management ───────────────────────────────────────────────────
+    /** Get all active routes */
+    getRoutes() {
+        return Array.from(this.routes.values());
+    }
+    /** Get session ID for a channel + chat */
+    getSessionId(channelType, chatId) {
+        return this.routes.get(`${channelType}:${chatId}`)?.sessionId;
+    }
+    /** Manually set a route (for restoring state) */
+    setRoute(route) {
+        this.routes.set(`${route.channelType}:${route.chatId}`, route);
+    }
+    /** Clean up stale routes (not active for given duration) */
+    pruneRoutes(maxIdleMs) {
+        const now = Date.now();
+        let pruned = 0;
+        for (const [key, route] of this.routes) {
+            if (now - route.lastActive > maxIdleMs) {
+                this.routes.delete(key);
+                pruned++;
+            }
+        }
+        return pruned;
+    }
+    /** Update policy for a channel */
+    setPolicy(channelType, policy) {
+        this.config.policies.set(channelType, policy);
+    }
+}
+//# sourceMappingURL=router.js.map

package/dist/channels/router.js.map

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

package/dist/channels/types.d.ts

@@ -0,0 +1,279 @@
+/**
+ * Mach6 — Channel System Type Definitions
+ *
+ * Core types for the message bus, channel adapters, and routing layer.
+ * Zero dependencies. This file imports nothing.
+ */
+export type MessagePriority = 'interrupt' | 'high' | 'normal' | 'low' | 'background';
+export interface BusEnvelope {
+    /** Unique envelope ID (UUID) */
+    id: string;
+    /** When the envelope entered the bus */
+    timestamp: number;
+    /** Processing priority */
+    priority: MessagePriority;
+    /** Where this message came from */
+    source: ChannelSource;
+    /** Which session should handle it (resolved by router) */
+    sessionId?: string;
+    /** The actual message content */
+    payload: InboundPayload;
+    /** Platform-specific preserved data */
+    metadata: EnvelopeMetadata;
+}
+export interface ChannelSource {
+    /** Channel type: "discord", "whatsapp", "telegram", etc. */
+    channelType: string;
+    /** Adapter instance ID: "discord-main", "wa-0987654321" */
+    adapterId: string;
+    /** Chat/conversation identifier on the platform */
+    chatId: string;
+    /** Chat type */
+    chatType: 'dm' | 'group' | 'channel' | 'thread';
+    /** Sender's platform-specific ID */
+    senderId: string;
+    /** Sender display name */
+    senderName?: string;
+    /** If this is a reply, the message being replied to */
+    replyToId?: string;
+    /** Thread ID if in a thread */
+    threadId?: string;
+    /** Mentioned user IDs */
+    mentions?: string[];
+}
+export type PayloadType = 'text' | 'media' | 'reaction' | 'edit' | 'delete' | 'typing' | 'presence' | 'system';
+export interface InboundPayload {
+    type: PayloadType;
+    text?: string;
+    media?: MediaPayload[];
+    reaction?: ReactionPayload;
+    edit?: EditPayload;
+    /** Original platform event — never discarded, never parsed by core */
+    raw?: unknown;
+}
+export interface MediaPayload {
+    type: 'image' | 'video' | 'audio' | 'document' | 'sticker' | 'voice';
+    url?: string;
+    path?: string;
+    mimeType?: string;
+    filename?: string;
+    sizeBytes?: number;
+    durationMs?: number;
+    width?: number;
+    height?: number;
+    /** Caption text (for platforms that support media + caption) */
+    caption?: string;
+}
+export interface ReactionPayload {
+    emoji: string;
+    messageId: string;
+    remove?: boolean;
+}
+export interface EditPayload {
+    messageId: string;
+    newText: string;
+}
+export interface EnvelopeMetadata {
+    /** Platform-specific message ID */
+    platformMessageId?: string;
+    /** Guild/server ID (Discord, Slack) */
+    guildId?: string;
+    /** Is this an ephemeral/disappearing message? */
+    ephemeral?: boolean;
+    /** Forwarded from another chat? */
+    forwarded?: boolean;
+    /** Additional platform data */
+    extra?: Record<string, unknown>;
+}
+export interface OutboundMessage {
+    /** Markdown content (agent output) */
+    content: string;
+    /** Media attachments */
+    media?: MediaPayload[];
+    /** Reply to a specific message */
+    replyToId?: string;
+    /** Post in a thread */
+    threadId?: string;
+    /** Ephemeral/disappearing */
+    ephemeral?: boolean;
+    /** Interactive components (buttons, keyboards) */
+    components?: MessageComponent[];
+    /** How to handle messages exceeding platform limit */
+    splitStrategy?: 'truncate' | 'paginate' | 'thread';
+    /** Priority for rate limiting */
+    priority?: 'interactive' | 'proactive' | 'background';
+}
+export interface MessageComponent {
+    type: 'button' | 'select' | 'action_row';
+    label?: string;
+    value?: string;
+    style?: string;
+    children?: MessageComponent[];
+}
+export interface SendResult {
+    success: boolean;
+    messageId?: string;
+    error?: string;
+    /** Timestamp when actually delivered (if platform confirms) */
+    deliveredAt?: number;
+}
+export type AdapterHealthState = 'connected' | 'degraded' | 'disconnected' | 'reconnecting';
+export interface AdapterHealth {
+    state: AdapterHealthState;
+    lastConnected: number;
+    disconnectCount: number;
+    lastError?: string;
+    uptimePercent?: number;
+    latencyMs?: number;
+}
+export interface ChannelCapabilities {
+    media: boolean;
+    reactions: boolean;
+    messageEdit: boolean;
+    messageDelete: boolean;
+    threads: boolean;
+    embeds: boolean;
+    components: boolean;
+    voiceNotes: boolean;
+    readReceipts: boolean;
+    typingIndicator: boolean;
+    ephemeral: boolean;
+    polls: boolean;
+    /** Platform's native formatting dialect */
+    formatting: 'markdown' | 'html' | 'plain' | 'whatsapp' | 'slack-mrkdwn';
+    /** Maximum message length in characters */
+    maxMessageLength: number;
+    /** Maximum media size in bytes */
+    maxMediaSize: number;
+    /** Rate limits */
+    rateLimits: RateLimitConfig;
+}
+export interface RateLimitConfig {
+    messagesPerSecond?: number;
+    messagesPerMinute?: number;
+    burstSize?: number;
+}
+export interface ChannelConfig {
+    /** Adapter-specific configuration (API keys, tokens, etc.) */
+    [key: string]: unknown;
+}
+/**
+ * Channel Adapter — the contract every platform adapter implements.
+ *
+ * 5 core methods + optional platform-specific actions.
+ * Adapters own their platform SDK. The bus and agent never touch it.
+ */
+export interface ChannelAdapter {
+    /** Unique adapter instance ID */
+    readonly id: string;
+    /** Channel type identifier */
+    readonly channelType: string;
+    /** What this platform supports */
+    readonly capabilities: ChannelCapabilities;
+    /** Initialize and connect to the platform */
+    connect(config: ChannelConfig, signal?: AbortSignal): Promise<void>;
+    /** Graceful disconnect */
+    disconnect(): Promise<void>;
+    /** Force reconnect (after disconnect/error) */
+    reconnect(): Promise<void>;
+    /** Current health status */
+    getHealth(): AdapterHealth;
+    /** Register handler for incoming messages. Adapter normalizes and calls handler. */
+    onMessage(handler: (envelope: BusEnvelope) => void): void;
+    /** Register handler for health state changes */
+    onHealthChange(handler: (health: AdapterHealth) => void): void;
+    /** Send a message to a target chat */
+    send(chatId: string, message: OutboundMessage): Promise<SendResult>;
+    /** React to a message with an emoji */
+    react?(chatId: string, messageId: string, emoji: string): Promise<void>;
+    /** Edit a previously sent message */
+    editMessage?(chatId: string, messageId: string, newContent: string): Promise<void>;
+    /** Delete a message */
+    deleteMessage?(chatId: string, messageId: string): Promise<void>;
+    /** Send typing indicator */
+    typing?(chatId: string, durationMs?: number): Promise<void>;
+    /** Mark a message as read */
+    markRead?(chatId: string, messageId: string): Promise<void>;
+}
+export interface ChannelPolicy {
+    /** DM handling: open to all, allowlist only, or deny all */
+    dmPolicy: 'open' | 'allowlist' | 'deny';
+    /** Group handling */
+    groupPolicy: 'open' | 'allowlist' | 'mention-only' | 'deny';
+    /** Allowed sender IDs (for allowlist mode) */
+    allowedSenders?: string[];
+    /** Allowed group IDs (for group allowlist) */
+    allowedGroups?: string[];
+    /** Owner IDs — always allowed, always high priority */
+    ownerIds: string[];
+    /** Require @mention in groups to trigger response */
+    requireMention?: boolean;
+    /** Bot's own ID on this platform (for mention detection) */
+    selfId?: string;
+    /** Sibling bot IDs — if a message @mentions a sibling but NOT us, yield */
+    siblingBotIds?: string[];
+}
+export interface SessionRoute {
+    /** Channel type + chat ID → session ID mapping */
+    channelType: string;
+    chatId: string;
+    sessionId: string;
+    /** When this route was last active */
+    lastActive: number;
+}
+export type BusEventType = 'message' | 'interrupt' | 'drain' | 'backpressure' | 'health';
+export interface BusEvent {
+    type: BusEventType;
+    envelope?: BusEnvelope;
+    sessionId?: string;
+    data?: unknown;
+}
+export type BusSubscription = {
+    unsubscribe(): void;
+};
+export interface MessageBus {
+    /** Publish an envelope to the bus */
+    publish(envelope: BusEnvelope): void;
+    /** Subscribe to messages for a session (filtered by priority) */
+    subscribe(sessionId: string, handler: (envelope: BusEnvelope) => void, filter?: {
+        priorities?: MessagePriority[];
+    }): BusSubscription;
+    /** Subscribe to interrupt signals for a session */
+    onInterrupt(sessionId: string, handler: (envelope: BusEnvelope) => void): BusSubscription;
+    /** Drain all pending messages for a session (removes from queue) */
+    drain(sessionId: string, filter?: {
+        priorities?: MessagePriority[];
+    }): BusEnvelope[];
+    /** Peek at pending count without draining */
+    pending(sessionId: string): number;
+    /** Current bus stats */
+    stats(): BusStats;
+}
+export interface BusStats {
+    totalPublished: number;
+    totalDelivered: number;
+    totalDropped: number;
+    pendingBySession: Map<string, number>;
+    queueDepth: number;
+}
+export interface OutboundFormatter {
+    /** Convert markdown to platform-native format */
+    format(markdown: string, capabilities: ChannelCapabilities): string;
+    /** Split content into chunks that fit platform limits */
+    split(content: string, maxLength: number): string[];
+}
+export declare class HealthTracker {
+    private _state;
+    private _lastConnected;
+    private _disconnectCount;
+    private _lastError?;
+    private _connectedSince;
+    private _totalConnectedMs;
+    private _trackingSince;
+    private _handlers;
+    get state(): AdapterHealthState;
+    get status(): AdapterHealth;
+    transition(to: AdapterHealthState, error?: string): boolean;
+    onChange(handler: (health: AdapterHealth) => void): void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/channels/types.d.ts.map

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

package/dist/channels/types.js

@@ -0,0 +1,67 @@
+/**
+ * Mach6 — Channel System Type Definitions
+ *
+ * Core types for the message bus, channel adapters, and routing layer.
+ * Zero dependencies. This file imports nothing.
+ */
+// ─── Health Tracker ────────────────────────────────────────────────────────
+const VALID_TRANSITIONS = {
+    connected: ['degraded', 'disconnected'],
+    degraded: ['connected', 'disconnected'],
+    disconnected: ['reconnecting'],
+    reconnecting: ['connected', 'disconnected'],
+};
+export class HealthTracker {
+    _state = 'disconnected';
+    _lastConnected = 0;
+    _disconnectCount = 0;
+    _lastError;
+    _connectedSince = 0;
+    _totalConnectedMs = 0;
+    _trackingSince = Date.now();
+    _handlers = [];
+    get state() { return this._state; }
+    get status() {
+        const now = Date.now();
+        let connectedMs = this._totalConnectedMs;
+        if (this._state === 'connected' && this._connectedSince > 0) {
+            connectedMs += now - this._connectedSince;
+        }
+        const totalMs = now - this._trackingSince;
+        return {
+            state: this._state,
+            lastConnected: this._lastConnected,
+            disconnectCount: this._disconnectCount,
+            lastError: this._lastError,
+            uptimePercent: totalMs > 0 ? Math.round((connectedMs / totalMs) * 100) : 0,
+        };
+    }
+    transition(to, error) {
+        const allowed = VALID_TRANSITIONS[this._state];
+        if (!allowed?.includes(to))
+            return false;
+        const now = Date.now();
+        if (this._state === 'connected' && this._connectedSince > 0) {
+            this._totalConnectedMs += now - this._connectedSince;
+            this._connectedSince = 0;
+        }
+        if (to === 'connected') {
+            this._lastConnected = now;
+            this._connectedSince = now;
+        }
+        if (to === 'disconnected') {
+            this._disconnectCount++;
+            if (error)
+                this._lastError = error;
+        }
+        this._state = to;
+        const status = this.status;
+        for (const h of this._handlers)
+            h(status);
+        return true;
+    }
+    onChange(handler) {
+        this._handlers.push(handler);
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/channels/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/channels/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgUH,8EAA8E;AAE9E,MAAM,iBAAiB,GAAqD;IAC1E,SAAS,EAAE,CAAC,UAAU,EAAE,cAAc,CAAC;IACvC,QAAQ,EAAE,CAAC,WAAW,EAAE,cAAc,CAAC;IACvC,YAAY,EAAE,CAAC,cAAc,CAAC;IAC9B,YAAY,EAAE,CAAC,WAAW,EAAE,cAAc,CAAC;CAC5C,CAAC;AAEF,MAAM,OAAO,aAAa;IAChB,MAAM,GAAuB,cAAc,CAAC;IAC5C,cAAc,GAAG,CAAC,CAAC;IACnB,gBAAgB,GAAG,CAAC,CAAC;IACrB,UAAU,CAAU;IACpB,eAAe,GAAG,CAAC,CAAC;IACpB,iBAAiB,GAAG,CAAC,CAAC;IACtB,cAAc,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC5B,SAAS,GAA2C,EAAE,CAAC;IAE/D,IAAI,KAAK,KAAyB,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IAEvD,IAAI,MAAM;QACR,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,WAAW,GAAG,IAAI,CAAC,iBAAiB,CAAC;QACzC,IAAI,IAAI,CAAC,MAAM,KAAK,WAAW,IAAI,IAAI,CAAC,eAAe,GAAG,CAAC,EAAE,CAAC;YAC5D,WAAW,IAAI,GAAG,GAAG,IAAI,CAAC,eAAe,CAAC;QAC5C,CAAC;QACD,MAAM,OAAO,GAAG,GAAG,GAAG,IAAI,CAAC,cAAc,CAAC;QAC1C,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,MAAM;YAClB,aAAa,EAAE,IAAI,CAAC,cAAc;YAClC,eAAe,EAAE,IAAI,CAAC,gBAAgB;YACtC,SAAS,EAAE,IAAI,CAAC,UAAU;YAC1B,aAAa,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,WAAW,GAAG,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;SAC3E,CAAC;IACJ,CAAC;IAED,UAAU,CAAC,EAAsB,EAAE,KAAc;QAC/C,MAAM,OAAO,GAAG,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC/C,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,CAAC;YAAE,OAAO,KAAK,CAAC;QAEzC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,IAAI,CAAC,MAAM,KAAK,WAAW,IAAI,IAAI,CAAC,eAAe,GAAG,CAAC,EAAE,CAAC;YAC5D,IAAI,CAAC,iBAAiB,IAAI,GAAG,GAAG,IAAI,CAAC,eAAe,CAAC;YACrD,IAAI,CAAC,eAAe,GAAG,CAAC,CAAC;QAC3B,CAAC;QACD,IAAI,EAAE,KAAK,WAAW,EAAE,CAAC;YACvB,IAAI,CAAC,cAAc,GAAG,GAAG,CAAC;YAC1B,IAAI,CAAC,eAAe,GAAG,GAAG,CAAC;QAC7B,CAAC;QACD,IAAI,EAAE,KAAK,cAAc,EAAE,CAAC;YAC1B,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACxB,IAAI,KAAK;gBAAE,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;QACrC,CAAC;QAED,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;QACjB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC3B,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,SAAS;YAAE,CAAC,CAAC,MAAM,CAAC,CAAC;QAC1C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,QAAQ,CAAC,OAAwC;QAC/C,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;CACF"}