@larksuite/openclaw-lark 2026.3.9

package/src/card/reply-dispatcher.js

@@ -0,0 +1,293 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Reply dispatcher factory for the Feishu/Lark channel plugin.
+ *
+ * Thin factory function that:
+ * 1. Resolves account, reply mode, and typing indicator config
+ * 2. In streaming mode, delegates to StreamingCardController
+ * 3. In static mode, delivers via sendMessageFeishu / sendMarkdownCardFeishu
+ * 4. Assembles and returns FeishuReplyDispatcherResult
+ */
+import { createReplyPrefixContext, createTypingCallbacks, logTypingFailure, } from 'openclaw/plugin-sdk';
+import { getLarkAccount } from '../core/accounts';
+import { resolveFooterConfig } from '../core/footer-config';
+import { LarkClient } from '../core/lark-client';
+import { larkLogger } from '../core/lark-logger';
+import { sendMessageFeishu, sendMarkdownCardFeishu } from '../messaging/outbound/send';
+import { addTypingIndicator, removeTypingIndicator } from '../messaging/outbound/typing';
+import { resolveReplyMode, expandAutoMode, shouldUseCard } from './reply-mode';
+import { StreamingCardController } from './streaming-card-controller';
+import { UnavailableGuard } from './unavailable-guard';
+const log = larkLogger('card/reply-dispatcher');
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+export function createFeishuReplyDispatcher(params) {
+    const core = LarkClient.runtime;
+    const { cfg, agentId, chatId, replyToMessageId, accountId, replyInThread } = params;
+    // Resolve account so we can read per-account config (e.g. replyMode)
+    const account = getLarkAccount(cfg, accountId);
+    const feishuCfg = account.config;
+    const prefixContext = createReplyPrefixContext({ cfg, agentId });
+    // ---- Reply mode resolution ----
+    const chatType = params.chatType;
+    const effectiveReplyMode = resolveReplyMode({ feishuCfg, chatType });
+    const replyMode = expandAutoMode({
+        mode: effectiveReplyMode,
+        streaming: feishuCfg?.streaming,
+        chatType,
+    });
+    const useStreamingCards = replyMode === 'streaming';
+    // ---- Block streaming for static mode ----
+    const enableBlockStreaming = feishuCfg?.blockStreaming === true && !useStreamingCards;
+    const resolvedFooter = resolveFooterConfig(feishuCfg?.footer);
+    log.info('reply mode resolved', {
+        effectiveReplyMode,
+        replyMode,
+        chatType,
+    });
+    // ---- Chunk & render settings (static mode only) ----
+    const textChunkLimit = core.channel.text.resolveTextChunkLimit(cfg, 'feishu', accountId, { fallbackLimit: 4000 });
+    const chunkMode = core.channel.text.resolveChunkMode(cfg, 'feishu');
+    const tableMode = core.channel.text.resolveMarkdownTableMode({
+        cfg,
+        channel: 'feishu',
+    });
+    // ---- Streaming card controller (instantiated only when needed) ----
+    const controller = useStreamingCards
+        ? new StreamingCardController({
+            cfg,
+            accountId,
+            chatId,
+            replyToMessageId,
+            replyInThread,
+            resolvedFooter,
+        })
+        : null;
+    // ---- Static mode unavailable guard ----
+    // In streaming mode the controller owns its own guard; in static mode
+    // we still need unavailable-message detection for typing and deliver.
+    let staticAborted = false;
+    const staticGuard = controller
+        ? null
+        : new UnavailableGuard({
+            replyToMessageId,
+            getCardMessageId: () => null,
+            onTerminate: () => {
+                staticAborted = true;
+            },
+        });
+    const shouldSkip = (source) => {
+        if (controller)
+            return controller.shouldSkipForUnavailable(source);
+        return staticGuard?.shouldSkip(source) ?? false;
+    };
+    const isTerminated = () => {
+        if (controller)
+            return controller.isTerminated;
+        return staticGuard?.isTerminated ?? false;
+    };
+    // ---- Typing indicator (reaction-based) ----
+    let typingState = null;
+    let typingStopped = false;
+    const typingCallbacks = createTypingCallbacks({
+        keepaliveIntervalMs: 0,
+        start: async () => {
+            if (shouldSkip('typing.start.precheck'))
+                return;
+            if (!replyToMessageId || typingStopped || params.skipTyping)
+                return;
+            if (typingState?.reactionId)
+                return;
+            typingState = await addTypingIndicator({
+                cfg,
+                messageId: replyToMessageId,
+                accountId,
+            });
+            if (shouldSkip('typing.start.postcheck'))
+                return;
+            if (typingStopped && typingState) {
+                await removeTypingIndicator({ cfg, state: typingState, accountId });
+                typingState = null;
+                log.info('removed typing indicator (raced with stop)');
+                return;
+            }
+            log.info('added typing indicator reaction');
+        },
+        stop: async () => {
+            typingStopped = true;
+            if (!typingState)
+                return;
+            await removeTypingIndicator({ cfg, state: typingState, accountId });
+            typingState = null;
+            log.info('removed typing indicator reaction');
+        },
+        onStartError: (err) => {
+            logTypingFailure({
+                log: (message) => log.warn(message),
+                channel: 'feishu',
+                action: 'start',
+                error: err,
+            });
+        },
+        onStopError: (err) => {
+            logTypingFailure({
+                log: (message) => log.warn(message),
+                channel: 'feishu',
+                action: 'stop',
+                error: err,
+            });
+        },
+    });
+    // ---- dispatchFullyComplete flag (static mode) ----
+    let dispatchFullyComplete = false;
+    // ---- Build dispatcher ----
+    const { dispatcher, replyOptions, markDispatchIdle } = core.channel.reply.createReplyDispatcherWithTyping({
+        responsePrefix: prefixContext.responsePrefix,
+        responsePrefixContextProvider: prefixContext.responsePrefixContextProvider,
+        humanDelay: core.channel.reply.resolveHumanDelayConfig(cfg, agentId),
+        onReplyStart: async () => {
+            if (shouldSkip('onReplyStart'))
+                return;
+            await typingCallbacks.onReplyStart?.();
+        },
+        deliver: async (payload) => {
+            log.debug('deliver called', { textPreview: payload.text?.slice(0, 100) });
+            if (shouldSkip('deliver.entry'))
+                return;
+            // ---- Abort guard ----
+            // Only check aborted (not isTerminalPhase) so that
+            // creation_failed can still fallthrough to static delivery.
+            if (staticAborted || controller?.isTerminated || controller?.isAborted) {
+                log.debug('deliver: skipped (aborted)');
+                return;
+            }
+            // ---- Post-dispatch guard ----
+            if (dispatchFullyComplete) {
+                log.debug('deliver: skipped (dispatch already complete)');
+                return;
+            }
+            const text = payload.text ?? '';
+            if (!text.trim()) {
+                log.debug('deliver: empty text, skipping');
+                return;
+            }
+            // ---- Streaming card mode ----
+            if (controller) {
+                await controller.ensureCardCreated();
+                if (controller.isTerminated)
+                    return;
+                if (controller.cardMessageId) {
+                    await controller.onDeliver(payload);
+                    return;
+                }
+                // Card creation failed — fall through to static delivery
+                log.warn('deliver: card creation failed, falling back to static delivery');
+            }
+            // ---- Static delivery ----
+            if (shouldUseCard(text)) {
+                const chunks = core.channel.text.chunkTextWithMode(text, textChunkLimit, chunkMode);
+                log.info('deliver: sending card chunks', { count: chunks.length, chatId });
+                for (const chunk of chunks) {
+                    try {
+                        await sendMarkdownCardFeishu({
+                            cfg,
+                            to: chatId,
+                            text: chunk,
+                            replyToMessageId,
+                            replyInThread,
+                            accountId,
+                        });
+                    }
+                    catch (err) {
+                        if (staticGuard?.terminate('deliver.cardChunk', err))
+                            return;
+                        throw err;
+                    }
+                }
+            }
+            else {
+                const converted = core.channel.text.convertMarkdownTables(text, tableMode);
+                const chunks = core.channel.text.chunkTextWithMode(converted, textChunkLimit, chunkMode);
+                log.info('deliver: sending text chunks', { count: chunks.length, chatId });
+                for (const chunk of chunks) {
+                    try {
+                        await sendMessageFeishu({
+                            cfg,
+                            to: chatId,
+                            text: chunk,
+                            replyToMessageId,
+                            replyInThread,
+                            accountId,
+                        });
+                    }
+                    catch (err) {
+                        if (staticGuard?.terminate('deliver.textChunk', err))
+                            return;
+                        throw err;
+                    }
+                }
+            }
+        },
+        onError: async (err, info) => {
+            if (controller) {
+                if (controller.terminateIfUnavailable('onError', err)) {
+                    typingCallbacks.onIdle?.();
+                    return;
+                }
+                await controller.onError(err, info);
+                typingCallbacks.onIdle?.();
+                return;
+            }
+            // Static mode error handling
+            if (staticGuard?.terminate('onError', err)) {
+                typingCallbacks.onIdle?.();
+                return;
+            }
+            log.error(`${info.kind} reply failed`, { error: String(err) });
+            typingCallbacks.onIdle?.();
+        },
+        onIdle: async () => {
+            if (isTerminated() || shouldSkip('onIdle')) {
+                typingCallbacks.onIdle?.();
+                return;
+            }
+            if (!dispatchFullyComplete) {
+                typingCallbacks.onIdle?.();
+                return;
+            }
+            if (controller) {
+                await controller.onIdle();
+            }
+            typingCallbacks.onIdle?.();
+        },
+        onCleanup: async () => {
+            typingCallbacks.onCleanup?.();
+        },
+    });
+    // ---- Abort card (delegates to controller or no-op for static) ----
+    const abortCard = controller ? () => controller.abortCard() : async () => { };
+    return {
+        dispatcher,
+        replyOptions: {
+            ...replyOptions,
+            onModelSelected: prefixContext.onModelSelected,
+            disableBlockStreaming: !enableBlockStreaming,
+            ...(controller
+                ? {
+                    onReasoningStream: (payload) => controller.onReasoningStream(payload),
+                    onPartialReply: (payload) => controller.onPartialReply(payload),
+                }
+                : {}),
+        },
+        markDispatchIdle,
+        markFullyComplete: () => {
+            dispatchFullyComplete = true;
+            controller?.markFullyComplete();
+        },
+        abortCard,
+    };
+}
+//# sourceMappingURL=reply-dispatcher.js.map

package/src/card/reply-dispatcher.js.map

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

package/src/card/reply-mode.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Pure functions for resolving the Feishu reply mode.
+ *
+ * Extracted from reply-dispatcher.ts to enable independent testing
+ * and eliminate `as any` casts on FeishuConfig.
+ */
+import type { FeishuConfig } from '../core/types';
+type ReplyModeValue = 'auto' | 'static' | 'streaming';
+/**
+ * Resolve the effective reply mode based on configuration and chat type.
+ *
+ * Priority: replyMode.{scene} > replyMode.default > replyMode (string) > "auto"
+ */
+export declare function resolveReplyMode(params: {
+    feishuCfg: FeishuConfig | undefined;
+    chatType?: 'p2p' | 'group';
+}): ReplyModeValue;
+/**
+ * Expand "auto" mode to a concrete mode based on streaming flag and chat type.
+ *
+ * When streaming === true: group → static, direct → streaming (legacy behavior).
+ * When streaming is unset: always static (new default).
+ */
+export declare function expandAutoMode(params: {
+    mode: ReplyModeValue;
+    streaming: boolean | undefined;
+    chatType?: 'p2p' | 'group';
+}): 'static' | 'streaming';
+/**
+ * Detect whether the text contains markdown elements that benefit from
+ * being rendered inside a Feishu interactive card (fenced code blocks or
+ * markdown tables).
+ */
+export declare function shouldUseCard(text: string): boolean;
+export {};
+//# sourceMappingURL=reply-mode.d.ts.map

package/src/card/reply-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reply-mode.d.ts","sourceRoot":"","sources":["../../../src/card/reply-mode.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAMlD,KAAK,cAAc,GAAG,MAAM,GAAG,QAAQ,GAAG,WAAW,CAAC;AAMtD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE;IACvC,SAAS,EAAE,YAAY,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC;CAC5B,GAAG,cAAc,CAcjB;AAMD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE;IACrC,IAAI,EAAE,cAAc,CAAC;IACrB,SAAS,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/B,QAAQ,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC;CAC5B,GAAG,QAAQ,GAAG,WAAW,CAKzB;AAMD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAUnD"}

package/src/card/reply-mode.js

@@ -0,0 +1,66 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Pure functions for resolving the Feishu reply mode.
+ *
+ * Extracted from reply-dispatcher.ts to enable independent testing
+ * and eliminate `as any` casts on FeishuConfig.
+ */
+// ---------------------------------------------------------------------------
+// resolveReplyMode
+// ---------------------------------------------------------------------------
+/**
+ * Resolve the effective reply mode based on configuration and chat type.
+ *
+ * Priority: replyMode.{scene} > replyMode.default > replyMode (string) > "auto"
+ */
+export function resolveReplyMode(params) {
+    const { feishuCfg, chatType } = params;
+    // streaming 布尔总开关：仅 true 时允许流式，未设置或 false 一律 static
+    if (feishuCfg?.streaming !== true)
+        return 'static';
+    const replyMode = feishuCfg?.replyMode;
+    if (!replyMode)
+        return 'auto';
+    if (typeof replyMode === 'string')
+        return replyMode;
+    // Object form: pick scene-specific value
+    const sceneMode = chatType === 'group' ? replyMode.group : chatType === 'p2p' ? replyMode.direct : undefined;
+    return sceneMode ?? replyMode.default ?? 'auto';
+}
+// ---------------------------------------------------------------------------
+// expandAutoMode
+// ---------------------------------------------------------------------------
+/**
+ * Expand "auto" mode to a concrete mode based on streaming flag and chat type.
+ *
+ * When streaming === true: group → static, direct → streaming (legacy behavior).
+ * When streaming is unset: always static (new default).
+ */
+export function expandAutoMode(params) {
+    const { mode, streaming, chatType } = params;
+    if (mode !== 'auto')
+        return mode;
+    return streaming === true ? (chatType === 'group' ? 'static' : 'streaming') : 'static';
+}
+// ---------------------------------------------------------------------------
+// shouldUseCard
+// ---------------------------------------------------------------------------
+/**
+ * Detect whether the text contains markdown elements that benefit from
+ * being rendered inside a Feishu interactive card (fenced code blocks or
+ * markdown tables).
+ */
+export function shouldUseCard(text) {
+    // Fenced code blocks
+    if (/```[\s\S]*?```/.test(text)) {
+        return true;
+    }
+    // Markdown tables (header + separator rows separated by pipes)
+    if (/\|.+\|[\r\n]+\|[-:| ]+\|/.test(text)) {
+        return true;
+    }
+    return false;
+}
+//# sourceMappingURL=reply-mode.js.map

package/src/card/reply-mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reply-mode.js","sourceRoot":"","sources":["../../../src/card/reply-mode.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAUH,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAGhC;IACC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;IAEvC,oDAAoD;IACpD,IAAI,SAAS,EAAE,SAAS,KAAK,IAAI;QAAE,OAAO,QAAQ,CAAC;IAEnD,MAAM,SAAS,GAAG,SAAS,EAAE,SAAS,CAAC;IACvC,IAAI,CAAC,SAAS;QAAE,OAAO,MAAM,CAAC;IAE9B,IAAI,OAAO,SAAS,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAEpD,yCAAyC;IACzC,MAAM,SAAS,GAAG,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7G,OAAO,SAAS,IAAI,SAAS,CAAC,OAAO,IAAI,MAAM,CAAC;AAClD,CAAC;AAED,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,MAI9B;IACC,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;IAC7C,IAAI,IAAI,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IAEjC,OAAO,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;AACzF,CAAC;AAED,8EAA8E;AAC9E,gBAAgB;AAChB,8EAA8E;AAE9E;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,qBAAqB;IACrB,IAAI,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,+DAA+D;IAC/D,IAAI,0BAA0B,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1C,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/src/card/streaming-card-controller.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Streaming card controller for the Feishu/Lark channel plugin.
+ *
+ * Manages the full lifecycle of a streaming CardKit card:
+ * idle → creating → streaming → completed / aborted / terminated.
+ *
+ * Delegates throttling to FlushController and message-unavailable
+ * detection to UnavailableGuard.
+ */
+import { type ReplyPayload } from 'openclaw/plugin-sdk';
+import type { CardPhase, TerminalReason, StreamingCardDeps } from './reply-dispatcher-types';
+export declare class StreamingCardController {
+    private phase;
+    private cardKit;
+    private text;
+    private reasoning;
+    private readonly flush;
+    private readonly guard;
+    private createEpoch;
+    private _terminalReason;
+    private dispatchFullyComplete;
+    private cardCreationPromise;
+    private disposeShutdownHook;
+    private readonly dispatchStartTime;
+    private readonly deps;
+    private elapsed;
+    constructor(deps: StreamingCardDeps);
+    get cardMessageId(): string | null;
+    get isTerminalPhase(): boolean;
+    /**
+     * Whether the card has been explicitly aborted (via abortCard()).
+     *
+     * Distinct from isTerminalPhase — creation_failed is NOT an abort;
+     * it should allow fallthrough to static delivery in the factory.
+     */
+    get isAborted(): boolean;
+    /** Whether the reply pipeline was terminated due to an unavailable message. */
+    get isTerminated(): boolean;
+    /** Check if the pipeline should skip further operations for this source. */
+    shouldSkipForUnavailable(source: string): boolean;
+    /** Attempt to terminate the pipeline due to an unavailable message error. */
+    terminateIfUnavailable(source: string, err?: unknown): boolean;
+    /** Why the controller entered a terminal phase, or null if still active. */
+    get terminalReason(): TerminalReason | null;
+    /** @internal — exposed for test assertions only. */
+    get currentPhase(): CardPhase;
+    /**
+     * Unified callback guard — returns true if the pipeline is active
+     * and the callback should proceed.
+     *
+     * Combines three checks:
+     * 1. guard.isTerminated — message recalled/deleted
+     * 2. guard.shouldSkip(source) — eagerly detect unavailable messages
+     * 3. isTerminalPhase — completed/aborted/terminated/creation_failed
+     */
+    private shouldProceed;
+    private isStaleCreate;
+    private transition;
+    private onEnterTerminalPhase;
+    /**
+     * Handle a deliver() call in streaming card mode.
+     *
+     * Accumulates text from the SDK's deliver callbacks to build the
+     * authoritative "completedText" for the final card.
+     */
+    onDeliver(payload: ReplyPayload): Promise<void>;
+    onReasoningStream(payload: ReplyPayload): Promise<void>;
+    onPartialReply(payload: ReplyPayload): Promise<void>;
+    onError(err: unknown, info: {
+        kind: string;
+    }): Promise<void>;
+    onIdle(): Promise<void>;
+    markFullyComplete(): void;
+    abortCard(): Promise<void>;
+    ensureCardCreated(): Promise<void>;
+    private performFlush;
+    private buildDisplayText;
+    private throttledCardUpdate;
+    private finalizeCard;
+    /**
+     * Close streaming mode then update card content (shared by onError and abortCard).
+     */
+    private closeStreamingAndUpdate;
+}
+//# sourceMappingURL=streaming-card-controller.d.ts.map

package/src/card/streaming-card-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming-card-controller.d.ts","sourceRoot":"","sources":["../../../src/card/streaming-card-controller.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAgB5E,OAAO,KAAK,EACV,SAAS,EACT,cAAc,EAId,iBAAiB,EAClB,MAAM,0BAA0B,CAAC;AA+ClC,qBAAa,uBAAuB;IAElC,OAAO,CAAC,KAAK,CAAqB;IAGlC,OAAO,CAAC,OAAO,CAKb;IACF,OAAO,CAAC,IAAI,CAKV;IACF,OAAO,CAAC,SAAS,CAKf;IAGF,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAkB;IACxC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAmB;IAGzC,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,eAAe,CAA+B;IACtD,OAAO,CAAC,qBAAqB,CAAS;IACtC,OAAO,CAAC,mBAAmB,CAA8B;IACzD,OAAO,CAAC,mBAAmB,CAA6B;IACxD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAc;IAGhD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAoB;IAEzC,OAAO,CAAC,OAAO;gBAIH,IAAI,EAAE,iBAAiB;IAkBnC,IAAI,aAAa,IAAI,MAAM,GAAG,IAAI,CAEjC;IAED,IAAI,eAAe,IAAI,OAAO,CAE7B;IAED;;;;;OAKG;IACH,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,+EAA+E;IAC/E,IAAI,YAAY,IAAI,OAAO,CAE1B;IAED,4EAA4E;IAC5E,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAIjD,6EAA6E;IAC7E,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,GAAG,OAAO;IAI9D,4EAA4E;IAC5E,IAAI,cAAc,IAAI,cAAc,GAAG,IAAI,CAE1C;IAED,oDAAoD;IACpD,IAAI,YAAY,IAAI,SAAS,CAE5B;IAMD;;;;;;;;OAQG;IACH,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,UAAU;IAgBlB,OAAO,CAAC,oBAAoB;IAY5B;;;;;OAKG;IACG,SAAS,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IA0C/C,iBAAiB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBvD,cAAc,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAoCpD,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAyC5D,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAuF7B,iBAAiB,IAAI,IAAI;IAQnB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAqD1B,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;YA2H1B,YAAY;IAwE1B,OAAO,CAAC,gBAAgB;YAQV,mBAAmB;IAUjC,OAAO,CAAC,YAAY;IAIpB;;OAEG;YACW,uBAAuB;CAgCtC"}