@xgjktech/xg_cwork_im 1.19.21 → 1.19.22

package/dist/src/delivery/inbound-terminal-state.js

@@ -0,0 +1,185 @@
+/**
+ * IM 入站消息终态：分类、用户可见文案、结构化日志字段。
+ */
+import { getSharedMap } from "../plugin/process-shared-store.js";
+const PRECHECK_MARKERS = [
+    "context overflow",
+    "context-overflow",
+    "overflowtokens",
+    "overflow tokens",
+    "prompt too large",
+    "precheck",
+    "too large for the model",
+    "too large for this model",
+    "promptbudget",
+];
+const TIMEOUT_MARKERS = ["request timed out", "timed out", "idle timeout", "llm idle timeout"];
+const NO_REPLY_MARKERS = ["no_reply", "no reply"];
+export function classifyRuntimeErrorMessage(message) {
+    const raw = message.trim();
+    const lower = raw.toLowerCase();
+    if (lower.includes("blocked attachment") ||
+        lower.includes("outside allowed roots") ||
+        lower.includes("not under an allowed directory")) {
+        return { errorType: "runtime_error", errorMessage: raw };
+    }
+    if (PRECHECK_MARKERS.some((m) => lower.includes(m))) {
+        return { errorType: "precheck_error", errorMessage: raw };
+    }
+    if (lower.includes("context-overflow-precheck") || (lower.includes("precheck") && lower.includes("overflow"))) {
+        return { errorType: "precheck_error", errorMessage: raw };
+    }
+    if (TIMEOUT_MARKERS.some((m) => lower.includes(m))) {
+        return { errorType: "timeout", errorMessage: raw };
+    }
+    if (NO_REPLY_MARKERS.some((m) => lower.includes(m))) {
+        return { errorType: "no_reply", errorMessage: raw };
+    }
+    if (lower.includes("compaction") && (lower.includes("incomplete") || lower.includes("failed"))) {
+        return { errorType: "compaction_failed", errorMessage: raw };
+    }
+    return { errorType: "runtime_error", errorMessage: raw };
+}
+export function classifyRuntimeError(err) {
+    if (err instanceof Error) {
+        return classifyRuntimeErrorMessage(err.message);
+    }
+    return classifyRuntimeErrorMessage(String(err));
+}
+export { buildTerminalUserMessage } from "./user-facing-errors.js";
+export function formatTerminalLogLine(fields) {
+    const parts = [
+        `[terminal] message_id=${fields.message_id}`,
+        `group_id=${fields.group_id}`,
+        `session_key=${fields.session_key}`,
+        fields.run_id ? `run_id=${fields.run_id}` : undefined,
+        `trigger=${fields.trigger}`,
+        `terminal_state=${fields.terminal_state}`,
+        `sent_to_im=${fields.sent_to_im}`,
+        fields.error_type ? `error_type=${fields.error_type}` : undefined,
+        fields.error_message ? `error_message=${JSON.stringify(fields.error_message)}` : undefined,
+        fields.no_reply_cause ? `no_reply_cause=${fields.no_reply_cause}` : undefined,
+        fields.deliver_invoke_count != null ? `deliver_invoke_count=${fields.deliver_invoke_count}` : undefined,
+        fields.deliver_call_count != null ? `deliver_call_count=${fields.deliver_call_count}` : undefined,
+        fields.normalizer_silent_skip != null
+            ? `normalizer_silent_skip=${fields.normalizer_silent_skip}`
+            : undefined,
+        fields.normalizer_heartbeat_skip != null
+            ? `normalizer_heartbeat_skip=${fields.normalizer_heartbeat_skip}`
+            : undefined,
+        fields.http_suppressed_reason ? `http_suppressed_reason=${fields.http_suppressed_reason}` : undefined,
+    ].filter(Boolean);
+    return parts.join(" ");
+}
+export function resolveHttpSuppressedReason(state, input) {
+    if (state !== "no_reply") {
+        return undefined;
+    }
+    if (input.normalizerSilentSkip) {
+        return "intentional_silent";
+    }
+    if (input.normalizerHeartbeatSkip) {
+        return "heartbeat_only";
+    }
+    return undefined;
+}
+/**
+ * 是否允许对 IM 发终态 HTTP。
+ * 不发：no_reply / timeout / compaction_failed（避免自造话或通道计时器误导）。
+ * 可发：投递失败、取消/覆盖、以及带上游原文的确认错误（文案为空时 trySend 仍会跳过）。
+ */
+export function shouldSendTerminalHttpForState(state, _input) {
+    switch (state) {
+        case "success":
+        case "no_reply":
+        case "timeout":
+        case "compaction_failed":
+            return false;
+        case "delivery_failed":
+        case "cancelled":
+        case "superseded":
+        case "precheck_error":
+        case "runtime_error":
+            return true;
+        default:
+            return false;
+    }
+}
+export function resolveNoReplyCause(input) {
+    if (input.hasBusinessReply) {
+        return undefined;
+    }
+    if (input.normalizerSilentSkip) {
+        return "intentional_silent";
+    }
+    if (input.normalizerHeartbeatSkip) {
+        return "heartbeat_only";
+    }
+    if (input.deliverInvokeCount === 0) {
+        return "zero_deliver";
+    }
+    if (input.deliverInvokeCount > 0 && input.deliverCallCount === 0) {
+        return "all_deliver_skipped";
+    }
+    return "unknown";
+}
+/** 在 finally 阶段根据观测信号推断终态（success 由 hasBusinessReply 在外层短路）。 */
+export function resolveTerminalState(input) {
+    if (input.hasBusinessReply) {
+        return "success";
+    }
+    if (input.timeoutFired) {
+        return "timeout";
+    }
+    if (input.lastDeliverError !== undefined) {
+        return "delivery_failed";
+    }
+    if (input.runtimeErrorHint) {
+        return input.runtimeErrorHint.errorType;
+    }
+    if (input.dispatchError !== undefined) {
+        return classifyRuntimeError(input.dispatchError).errorType;
+    }
+    if (input.beforeAgentRunBlocked) {
+        return "precheck_error";
+    }
+    if (input.compactionIncomplete || (input.compactionShown && input.deliverCallCount === 0)) {
+        return "compaction_failed";
+    }
+    if (input.deliverInvokeCount > 0 &&
+        input.deliverCallCount === 0 &&
+        input.runtimeErrorHint === undefined &&
+        input.dispatchError === undefined &&
+        input.lastDeliverError === undefined) {
+        return "no_reply";
+    }
+    if (input.deliverInvokeCount === 0 && !input.dispatchThrew) {
+        return "no_reply";
+    }
+    return "runtime_error";
+}
+/** 进程级幂等：同一 message_id 终态 HTTP 最多发一次（跨模块重载共享）。 */
+const globalTerminalSent = getSharedMap("global-terminal-sent");
+export function hasGlobalTerminalSent(messageId) {
+    return globalTerminalSent.has(messageId.trim());
+}
+export function markGlobalTerminalSent(messageId, state) {
+    const id = messageId.trim();
+    if (!id)
+        return;
+    if (!globalTerminalSent.has(id)) {
+        globalTerminalSent.set(id, state);
+    }
+}
+export function peekGlobalTerminalSent(messageId) {
+    return globalTerminalSent.get(messageId.trim());
+}
+/** 测试用：清空进程级幂等表。 */
+export function resetGlobalTerminalSentForTests() {
+    disposeGlobalTerminalSent();
+}
+/** 插件卸载/重载时清空终态幂等表。 */
+export function disposeGlobalTerminalSent() {
+    globalTerminalSent.clear();
+}
+//# sourceMappingURL=inbound-terminal-state.js.map

package/dist/src/delivery/inbound-terminal-state.js.map

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

package/dist/src/delivery/inbound-terminal-state.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbound-terminal-state.test.d.ts","sourceRoot":"","sources":["../../../src/delivery/inbound-terminal-state.test.ts"],"names":[],"mappings":""}

package/dist/src/delivery/inbound-terminal-state.test.js.map

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

package/dist/src/delivery/send-file-event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-file-event.d.ts","sourceRoot":"","sources":["../../../src/delivery/send-file-event.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,mBAAmB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAkB,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC9D,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,EAAE;QACL,IAAI,EAAE;YACF,MAAM,EAAE,MAAM,CAAC;YACf,QAAQ,EAAE,MAAM,CAAC;YACjB,QAAQ,EAAE,MAAM,CAAC;YACjB,MAAM,EAAE,MAAM,CAAC;YACf,IAAI,EAAE,MAAM,CAAC;SAChB,CAAC;KACL,CAAC;CACL;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI,CA6BlE"}

package/dist/src/delivery/send-file-event.js

@@ -0,0 +1,33 @@
+import { getPlanWsClient } from "../plan/plan-ws-registry.js";
+const LOG_PREFIX = "[xg_cwork_im] [send-file-event]";
+/**
+ * 当文件发送成功后，向前端 WS 客户端推送 CHAT_FILE 事件。
+ * 保持同步返回：网络发送在内部 fire-and-forget。
+ */
+export function sendFileRunEvent(params) {
+    const { groupId, fileId, fileName, fileSize, format, path } = params;
+    if (!groupId) {
+        console.warn(`${LOG_PREFIX} groupId 缺失，跳过 CHAT_FILE fileId=${fileId}`);
+        return;
+    }
+    const target = getPlanWsClient(groupId);
+    if (!target) {
+        console.warn(`${LOG_PREFIX} 未登记 WS client，跳过 CHAT_FILE fileId=${fileId} groupId=${groupId}`);
+        return;
+    }
+    const data = {
+        status: "completed",
+        payload: {
+            data: { fileId, fileName, fileSize, format, path },
+        },
+    };
+    void target.client.sendEvent({
+        groupId,
+        replyToMsgId: target.replyToMsgId,
+        event: "CHAT_FILE",
+        data,
+    }).catch((err) => {
+        console.warn(`${LOG_PREFIX} 发送失败 fileId=${fileId} groupId=${groupId}: ${String(err)}`);
+    });
+}
+//# sourceMappingURL=send-file-event.js.map

package/dist/src/delivery/send-file-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-file-event.js","sourceRoot":"","sources":["../../../src/delivery/send-file-event.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAE9D,MAAM,UAAU,GAAG,iCAAiC,CAAC;AAwBrD;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAA2B;IACxD,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC;IAErE,IAAI,CAAC,OAAO,EAAE,CAAC;QACX,OAAO,CAAC,IAAI,CAAC,GAAG,UAAU,mCAAmC,MAAM,EAAE,CAAC,CAAC;QACvE,OAAO;IACX,CAAC;IAED,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IACxC,IAAI,CAAC,MAAM,EAAE,CAAC;QACV,OAAO,CAAC,IAAI,CAAC,GAAG,UAAU,sCAAsC,MAAM,YAAY,OAAO,EAAE,CAAC,CAAC;QAC7F,OAAO;IACX,CAAC;IAED,MAAM,IAAI,GAAsB;QAC5B,MAAM,EAAE,WAAW;QACnB,OAAO,EAAE;YACL,IAAI,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE;SACrD;KACJ,CAAC;IAEF,KAAK,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC;QACzB,OAAO;QACP,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,KAAK,EAAE,WAAW;QAClB,IAAI;KACP,CAAC,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;QACtB,OAAO,CAAC,IAAI,CAAC,GAAG,UAAU,gBAAgB,MAAM,YAAY,OAAO,KAAK,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC3F,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/src/delivery/send-file-event.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-file-event.test.d.ts","sourceRoot":"","sources":["../../../src/delivery/send-file-event.test.ts"],"names":[],"mappings":""}

package/dist/src/delivery/send-file-event.test.js

@@ -0,0 +1,86 @@
+import assert from "node:assert/strict";
+import { beforeEach, describe, it } from "node:test";
+import { resetPlanWsRegistryForTest, setPlanWsClient } from "../plan/plan-ws-registry.js";
+import { sendFileRunEvent } from "./send-file-event.js";
+function makeRecordingClient() {
+    const calls = [];
+    return {
+        calls,
+        client: {
+            start: async () => { },
+            streamProgress: async () => { },
+            streamUsage: async () => { },
+            sendEvent: async (opts) => {
+                calls.push(opts);
+            },
+            end: async () => { },
+        },
+    };
+}
+beforeEach(() => resetPlanWsRegistryForTest());
+describe("sendFileRunEvent", () => {
+    it("成功向已登记 WS 客户端推送 CHAT_FILE 事件", () => {
+        const { client, calls } = makeRecordingClient();
+        setPlanWsClient("g-1", client, "msg-1");
+        sendFileRunEvent({
+            groupId: "g-1",
+            fileId: "res-file-123",
+            fileName: "report.pdf",
+            fileSize: 1048576,
+            format: "pdf",
+            path: "output/report.pdf",
+        });
+        assert.equal(calls.length, 1);
+        assert.equal(calls[0].event, "CHAT_FILE");
+        assert.equal(calls[0].groupId, "g-1");
+        assert.equal(calls[0].replyToMsgId, "msg-1");
+        const data = calls[0].data;
+        assert.deepEqual(data, {
+            status: "completed",
+            payload: {
+                data: {
+                    fileId: "res-file-123",
+                    fileName: "report.pdf",
+                    fileSize: 1048576,
+                    format: "pdf",
+                    path: "output/report.pdf",
+                },
+            },
+        });
+    });
+    it("未登记 WS client 时安全跳过且不抛出异常", () => {
+        assert.doesNotThrow(() => {
+            sendFileRunEvent({
+                groupId: "g-unregistered",
+                fileId: "res-file-123",
+                fileName: "report.pdf",
+                fileSize: 1048576,
+                format: "pdf",
+                path: "output/report.pdf",
+            });
+        });
+    });
+    it("sendEvent 异步抛错时静默处理，不中断主流程", () => {
+        const rejectingClient = {
+            start: async () => { },
+            streamProgress: async () => { },
+            streamUsage: async () => { },
+            sendEvent: async () => {
+                throw new Error("WS send error");
+            },
+            end: async () => { },
+        };
+        setPlanWsClient("g-err", rejectingClient, "msg-err");
+        assert.doesNotThrow(() => {
+            sendFileRunEvent({
+                groupId: "g-err",
+                fileId: "res-file-123",
+                fileName: "report.pdf",
+                fileSize: 1048576,
+                format: "pdf",
+                path: "output/report.pdf",
+            });
+        });
+    });
+});
+//# sourceMappingURL=send-file-event.test.js.map

package/dist/src/delivery/send-file-event.test.js.map

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

package/dist/src/delivery/send-service.d.ts

@@ -0,0 +1,83 @@
+/**
+ * XG-IM 消息发送模块
+ *
+ * 调用 IM 接口将 AI 回复发送到指定群聊，并 @ 原始发送者。
+ * 支持 RICH_TEXT 与带资源 fileId 的 FILE 类型（attachments）。
+ */
+import type { Log } from "../plugin/auth.js";
+import type { SendMessageFileAttachment, SendMessageReply, XgImConfig } from "../plugin/types.js";
+/**
+ * 生成一次投递的客户端幂等键。
+ *
+ * 服务端按 `clientMsgId + groupId + 最近 10 分钟` 去重：同一逻辑消息在其内部 6 次重试间
+ * 复用同一 `clientMsgId`，超时/断连重发会命中服务端已有消息，不产生重复气泡。
+ * 每个独立投递块生成一次（不同块必须不同）。
+ */
+export declare function generateClientMsgId(): string;
+/** 从发送接口响应中解析服务端消息 id（`data.id`）与回显 `clientMsgId`，用于对账日志。 */
+export declare function extractSentMessageInfo(resData: unknown): {
+    serverMsgId?: string;
+    clientMsgId?: string;
+};
+/** OpenClaw dispatch deliver 单块载荷：文本 + 可选媒体 URL（与 plugin-sdk 约定对齐）。 */
+export type ReplyDeliverPayload = {
+    markdown?: string;
+    text?: string;
+    isThinking?: boolean;
+    mediaUrl?: string;
+    mediaUrls?: string[];
+    /** OpenClaw 运营通知：模型 failover 状态变化（非助手正文） */
+    isFallbackNotice?: boolean;
+    isCompactionNotice?: boolean;
+    isError?: boolean;
+    /** OpenClaw assistant thinking/reasoning 块（对应 transcript type: thinking） */
+    isReasoning?: boolean;
+};
+/**
+ * 将 deliver 块发到 IM：若有媒体则先 POST baseUrl/file/upDownload/uploadWholeFile 再发 FILE；否则发 RICH_TEXT。
+ *
+ * @param agentWorkspaceDir  可选。Agent 在宿主机的 workspace 绝对路径（由 resolveAgentWorkspaceDir 得到）。
+ *                           用于在多沙箱 agent 场景下正确解析 /workspace/ 前缀路径。
+ *                           未传时回退到 process.cwd()，单 agent 部署下行为不变。
+ */
+export declare function sendReplyDeliverBlock(config: XgImConfig, token: string, groupId: string, payload: ReplyDeliverPayload, atUserIds?: string[], log?: Log, _deprecatedMsgId?: string, reply?: SendMessageReply, agentWorkspaceDir?: string): Promise<void>;
+/**
+ * 发送一条已上传资源的 FILE 消息到指定 IM 群聊。
+ *
+ * 与 {@link sendReplyDeliverBlock} 不同：本函数**不做** URL 下载 / 上传失败降级为文本的逻辑，
+ * 仅负责把已经拿到 fileId 的附件组装成 FILE 消息发出。失败直接抛出，由调用方（工具）返回明确错误，
+ * 不会产生「降级成文本却报成功」的假成功。上传步骤请在调用前用
+ * {@link uploadWholeResourceFileWithRetry} 完成。
+ *
+ * 复用 {@link postImMessage} 的 6 次网络重试与服务端 clientMsgId 去重。
+ */
+export declare function sendUploadedFileMessage(args: {
+    config: XgImConfig;
+    token: string;
+    groupId: string;
+    /** 附件说明；为空时用单空格占位，避免部分 IM 接口拒收空文本 */
+    caption?: string;
+    attachment: SendMessageFileAttachment;
+    atUserIds?: string[];
+    /** 幂等键；省略时自动生成 */
+    clientMsgId?: string;
+    reply?: SendMessageReply;
+    log?: Log;
+}): Promise<{
+    clientMsgId: string;
+    serverMsgId?: string;
+}>;
+/**
+ * 发送文本消息到指定 IM 群聊。
+ *
+ * @param config     插件配置
+ * @param token      鉴权 token
+ * @param groupId    目标群聊 ID（gid / groupId）
+ * @param content    消息内容文本
+ * @param atUserIds  需要 @ 的用户 ID 列表（可为空）
+ * @param log        日志接口
+ * @param _deprecatedMsgId  已废弃的占位消息 ID 参数，不再使用（保留以兼容旧调用签名）
+ * @param reply      可选的被回复消息信息（用于在 IM 中建立“回复某条消息”的关联）
+ */
+export declare function sendTextMessage(config: XgImConfig, token: string, groupId: string, content: string, atUserIds?: string[], log?: Log, _deprecatedMsgId?: string, reply?: SendMessageReply): Promise<void>;
+//# sourceMappingURL=send-service.d.ts.map

package/dist/src/delivery/send-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-service.d.ts","sourceRoot":"","sources":["../../../src/delivery/send-service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAW7C,OAAO,KAAK,EAAmB,yBAAyB,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AA6BnH;;;;;;GAMG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED,6DAA6D;AAC7D,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,CAQvG;AA0KD,uEAAuE;AACvE,MAAM,MAAM,mBAAmB,GAAG;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,4CAA4C;IAC5C,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,4EAA4E;IAC5E,WAAW,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACvC,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,mBAAmB,EAC5B,SAAS,GAAE,MAAM,EAAO,EACxB,GAAG,CAAC,EAAE,GAAG,EACT,gBAAgB,CAAC,EAAE,MAAM,EACzB,KAAK,CAAC,EAAE,gBAAgB,EACxB,iBAAiB,CAAC,EAAE,MAAM,GAC3B,OAAO,CAAC,IAAI,CAAC,CA2Gf;AAED;;;;;;;;;GASG;AACH,wBAAsB,uBAAuB,CAAC,IAAI,EAAE;IAChD,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,yBAAyB,CAAC;IACtC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,kBAAkB;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,GAAG,CAAC,EAAE,GAAG,CAAC;CACb,GAAG,OAAO,CAAC;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAkBzD;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,eAAe,CACjC,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,SAAS,GAAE,MAAM,EAAO,EACxB,GAAG,CAAC,EAAE,GAAG,EACT,gBAAgB,CAAC,EAAE,MAAM,EACzB,KAAK,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,IAAI,CAAC,CAgBf"}