@xgjktech/xg_cwork_im 1.19.22 → 1.19.23

package/dist/src/run-usage.test.js

@@ -0,0 +1,178 @@
+import assert from "node:assert/strict";
+import { describe, it } from "node:test";
+import { buildRunUsageFromSessionEntry, hasReportableUsage, mergeRunModelContextFields, toImStreamRunUsageData, } from "./run-usage.js";
+describe("buildRunUsageFromSessionEntry", () => {
+    it("maps session store fields to RUN_USAGE snapshot", () => {
+        const u = buildRunUsageFromSessionEntry({
+            modelProvider: "openai",
+            model: "gpt-5.5",
+            inputTokens: 1_200,
+            outputTokens: 89,
+            cacheRead: 10_000,
+            cacheWrite: 0,
+            estimatedCostUsd: 0.0123,
+        }, { runId: "run-1" });
+        assert.ok(u);
+        assert.equal(u.source, "session");
+        assert.equal(u.provider, "openai");
+        assert.equal(u.model, "gpt-5.5");
+        assert.equal(u.modelRef, "openai/gpt-5.5");
+        assert.equal(u.inputTokens, 1_200);
+        assert.equal(u.outputTokens, 89);
+        assert.equal(u.totalTokens, undefined);
+        assert.equal(u.cacheReadTokens, 10_000);
+        assert.equal(u.cacheWriteTokens, 0);
+        assert.equal(u.estimatedCostUsd, 0.0123);
+        assert.equal(u.runId, "run-1");
+    });
+    it("maps context ring fields (contextTokens / promptBudget / freshness)", () => {
+        const u = buildRunUsageFromSessionEntry({
+            modelProvider: "openai",
+            model: "gpt-5.5",
+            inputTokens: 100,
+            outputTokens: 20,
+            totalTokens: 26_002,
+            totalTokensFresh: false,
+            contextTokens: 200_000,
+            promptBudgetBeforeReserve: 180_000,
+        });
+        assert.ok(u);
+        assert.equal(u.totalTokens, 26_002);
+        assert.equal(u.totalTokensFresh, false);
+        assert.equal(u.contextTokens, 200_000);
+        assert.equal(u.promptBudgetBeforeReserve, 180_000);
+    });
+    it("prefers explicit totalTokens from session", () => {
+        const u = buildRunUsageFromSessionEntry({
+            modelProvider: "xgjk-newapi",
+            model: "MiniMax-M2.7-Cloud",
+            inputTokens: 100,
+            outputTokens: 20,
+            totalTokens: 26_002,
+        });
+        assert.ok(u);
+        assert.equal(u.totalTokens, 26_002);
+    });
+    it("does not fall back to input+output for totalTokens (context snapshot only)", () => {
+        const u = buildRunUsageFromSessionEntry({
+            inputTokens: 10,
+            outputTokens: 2,
+        });
+        assert.ok(u);
+        assert.equal(u.totalTokens, undefined);
+        assert.equal(u.modelRef, undefined);
+    });
+    it("accepts model-only entry", () => {
+        const u = buildRunUsageFromSessionEntry({
+            modelProvider: "openai",
+            model: "gpt-5.5",
+        });
+        assert.ok(u);
+        assert.equal(u.modelRef, "openai/gpt-5.5");
+        assert.equal(u.inputTokens, undefined);
+        assert.equal(hasReportableUsage(u), true);
+    });
+    it("returns undefined for empty entry", () => {
+        assert.equal(buildRunUsageFromSessionEntry({}), undefined);
+        assert.equal(buildRunUsageFromSessionEntry(null), undefined);
+        assert.equal(buildRunUsageFromSessionEntry(undefined), undefined);
+    });
+});
+describe("toImStreamRunUsageData", () => {
+    it("omits undefined optional fields", () => {
+        const data = toImStreamRunUsageData({
+            provider: "openai",
+            model: "gpt-5.5",
+            modelRef: "openai/gpt-5.5",
+            inputTokens: 100,
+            outputTokens: 5,
+            totalTokens: 105,
+            source: "session",
+        }, { groupId: "g1", replyToMsgId: "m1" });
+        assert.deepEqual(data, {
+            groupId: "g1",
+            replyToMsgId: "m1",
+            usage: {
+                provider: "openai",
+                model: "gpt-5.5",
+                modelRef: "openai/gpt-5.5",
+                inputTokens: 100,
+                outputTokens: 5,
+                totalTokens: 105,
+                source: "session",
+            },
+        });
+    });
+    it("passes context ring fields through to the wire payload", () => {
+        const data = toImStreamRunUsageData({
+            inputTokens: 100,
+            outputTokens: 5,
+            totalTokens: 26_002,
+            totalTokensFresh: true,
+            contextTokens: 200_000,
+            promptBudgetBeforeReserve: 180_000,
+            source: "session",
+        }, { groupId: "g1", replyToMsgId: "m1" });
+        assert.deepEqual(data.usage, {
+            inputTokens: 100,
+            outputTokens: 5,
+            totalTokens: 26_002,
+            totalTokensFresh: true,
+            contextTokens: 200_000,
+            promptBudgetBeforeReserve: 180_000,
+            source: "session",
+        });
+    });
+});
+describe("mergeRunModelContextFields", () => {
+    it("fills missing model and contextTokens from the captured llm_output context", () => {
+        const merged = mergeRunModelContextFields({ inputTokens: 2_084, outputTokens: 92, totalTokens: 40_052 }, {
+            provider: "xgjk-newapi",
+            model: "MiniMax-M2.7-Cloud",
+            contextTokenBudget: 200_000,
+            updatedAt: Date.now(),
+        });
+        assert.deepEqual(merged, {
+            inputTokens: 2_084,
+            outputTokens: 92,
+            totalTokens: 40_052,
+            modelProvider: "xgjk-newapi",
+            model: "MiniMax-M2.7-Cloud",
+            contextTokens: 200_000,
+        });
+    });
+    it("keeps entry values when already present", () => {
+        const merged = mergeRunModelContextFields({
+            modelProvider: "openai",
+            model: "gpt-5.5",
+            contextTokens: 128_000,
+            totalTokens: 1_000,
+        }, {
+            provider: "other",
+            model: "other-model",
+            contextTokenBudget: 200_000,
+            updatedAt: Date.now(),
+        });
+        assert.equal(merged.modelProvider, "openai");
+        assert.equal(merged.model, "gpt-5.5");
+        assert.equal(merged.contextTokens, 128_000);
+    });
+    it("does not fabricate fields when the captured context is empty", () => {
+        const merged = mergeRunModelContextFields({ inputTokens: 1, outputTokens: 1 }, { updatedAt: Date.now() });
+        assert.deepEqual(merged, { inputTokens: 1, outputTokens: 1 });
+    });
+    it("merged fields produce a reportable snapshot with modelRef", () => {
+        const merged = mergeRunModelContextFields({ totalTokens: 40_052 }, {
+            provider: "xgjk-newapi",
+            model: "MiniMax-M2.7-Cloud",
+            contextTokenBudget: 200_000,
+            updatedAt: Date.now(),
+        });
+        const usage = buildRunUsageFromSessionEntry(merged);
+        assert.ok(usage);
+        assert.equal(usage.modelRef, "xgjk-newapi/MiniMax-M2.7-Cloud");
+        assert.equal(usage.contextTokens, 200_000);
+        assert.equal(usage.totalTokens, 40_052);
+    });
+});
+//# sourceMappingURL=run-usage.test.js.map

package/dist/src/run-usage.test.js.map

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

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

@@ -0,0 +1,26 @@
+export interface SendFileEventParams {
+    groupId: string;
+    fileId: string;
+    fileName: string;
+    fileSize: number;
+    format: string;
+    path: string;
+}
+export interface SendFileEventData extends Record<string, unknown> {
+    status: "completed";
+    payload: {
+        data: {
+            fileId: string;
+            fileName: string;
+            fileSize: number;
+            format: string;
+            path: string;
+        };
+    };
+}
+/**
+ * 当文件发送成功后，向前端 WS 客户端推送 CHAT_FILE 事件。
+ * 保持同步返回：网络发送在内部 fire-and-forget。
+ */
+export declare function sendFileRunEvent(params: SendFileEventParams): void;
+//# sourceMappingURL=send-file-event.d.ts.map

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

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

@@ -0,0 +1,33 @@
+import { getPlanWsClient } from "./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/send-file-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-file-event.js","sourceRoot":"","sources":["../../src/send-file-event.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,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/send-file-event.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=send-file-event.test.d.ts.map

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

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

package/dist/src/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-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/send-file-event.test.js.map

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

package/dist/src/send-file-tool.d.ts

@@ -0,0 +1,81 @@
+/**
+ * XG-IM 文件发送工具（`xg_cwork_im_send_file`）
+ *
+ * 直接发送当前 Agent workspace 内的文件到**当前 IM 会话**：校验 workspace 路径与文件 → 上传资源中心 →
+ * 发送 FILE 消息。避免 HTML/SVG 等经 `MEDIA:` + OpenClaw 本地媒体安全规则被拦截。
+ *
+ * 与 `xg_cwork_im_send_group_message`（仅纯文本、需模型给 groupId）不同：
+ * - groupId / accountId 从注入的会话上下文（deliveryContext）获取，模型不可指定；
+ * - 上传或发送失败一律返回 `ok:false`，绝不降级成文本后谎报成功。
+ */
+import type { AnyAgentTool } from "openclaw/plugin-sdk/agent-harness-runtime";
+import type { XgImConfig } from "./types.js";
+/** 由 OpenClaw 工具工厂上下文（`ctx`）节选注入，模型不可见、不可篡改。 */
+export type XgImSendFileToolHints = {
+    /** Agent 在宿主机上的 workspace 根目录（ctx.workspaceDir） */
+    workspaceDir?: string;
+    /** 当前 Agent ID（ctx.agentId），仅用于日志 */
+    agentId?: string;
+    /** 当前 IM 通道账户（ctx.agentAccountId） */
+    channelAccountId?: string;
+    /** 当前发送者 userId（ctx.requesterSenderId） */
+    requesterSenderId?: string;
+    /** 当前投递目标：channel / to(=groupId) / accountId / threadId（ctx.deliveryContext） */
+    deliveryContext?: {
+        channel?: string | null;
+        to?: string | null;
+        accountId?: string | null;
+        threadId?: string | number | null;
+    } | null;
+};
+export type SendFileErrorCode = "NO_XG_IM_CONTEXT" | "NO_DELIVERY_TARGET" | "NO_WORKSPACE" | "ACCOUNT_MISMATCH" | "ACCOUNT_NOT_FOUND" | "FILE_NOT_FOUND" | "PATH_IS_DIRECTORY" | "PATH_OUTSIDE_WORKSPACE" | "SYMLINK_ESCAPE" | "EMPTY_FILE" | "FILE_TOO_LARGE" | "EXTENSION_NOT_ALLOWED" | "AUTH_FAILED" | "READ_FAILED" | "UPLOAD_FAILED" | "MESSAGE_SEND_FAILED";
+export declare class SendFileError extends Error {
+    readonly code: SendFileErrorCode;
+    constructor(code: SendFileErrorCode, message: string);
+}
+/**
+ * 将模型传入的 path 解析为 workspace 内的宿主机绝对路径。
+ *
+ * 校验顺序与 docs/send-file-tool-design.md §3 一致：
+ * 去前缀 → 拒绝绝对/URL/UNC/.. → resolve 后仍在 workspace → realpath 防符号链接逃逸 →
+ * isFile → 存在/非空/不超限 → 拒绝可执行扩展名。
+ *
+ * @returns 解析后的真实路径、字节数与源文件名。
+ */
+export declare function resolveWorkspaceFile(workspaceDir: string, inputPath: string, maxBytes: number): Promise<{
+    realPath: string;
+    size: number;
+    sourceName: string;
+}>;
+/**
+ * 依据可选的 fileName 生成用户可见文件名：
+ * 去掉路径部分与非法字符，并强制沿用源文件扩展名（不允许模型改扩展名）。
+ */
+export declare function resolveDisplayFileName(sourceName: string, fileNameParam?: string): string;
+/**
+ * 从两个可信来源（deliveryContext.accountId、agentAccountId）确定账户 ID：
+ * 两者都存在且不一致时视为上下文冲突，拒绝执行（避免用错机器人）。
+ */
+export declare function selectTrustedAccountId(deliveryAccountId?: string | null, channelAccountId?: string): {
+    accountId?: string;
+} | {
+    conflict: {
+        a: string;
+        b: string;
+    };
+};
+/**
+ * 严格解析账户配置：
+ * - 单账户模式（无 accounts）：直接返回顶层配置。
+ * - 多账户模式：指定账户必须存在；未指定账户时仅当只有一个非 default 账户才可自动选定，
+ *   否则视为无法确定账户而拒绝。**不会**像 {@link resolveAccountConfig} 那样静默回退到第一个账户。
+ */
+export declare function resolveAccountConfigStrict(base: XgImConfig, accountId?: string): {
+    config: XgImConfig;
+    accountId?: string;
+} | {
+    error: "ACCOUNT_NOT_FOUND";
+    message: string;
+};
+export declare function buildSendFileTool(config: XgImConfig, hints?: XgImSendFileToolHints): AnyAgentTool;
+//# sourceMappingURL=send-file-tool.d.ts.map

package/dist/src/send-file-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-file-tool.d.ts","sourceRoot":"","sources":["../../src/send-file-tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2CAA2C,CAAC;AAY9E,OAAO,KAAK,EAA0C,UAAU,EAAE,MAAM,YAAY,CAAC;AA2BrF,gDAAgD;AAChD,MAAM,MAAM,qBAAqB,GAAG;IAChC,mDAAmD;IACnD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,0CAA0C;IAC1C,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gFAAgF;IAChF,eAAe,CAAC,EAAE;QACd,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;KACrC,GAAG,IAAI,CAAC;CACZ,CAAC;AAIF,MAAM,MAAM,iBAAiB,GACvB,kBAAkB,GAClB,oBAAoB,GACpB,cAAc,GACd,kBAAkB,GAClB,mBAAmB,GACnB,gBAAgB,GAChB,mBAAmB,GACnB,wBAAwB,GACxB,gBAAgB,GAChB,YAAY,GACZ,gBAAgB,GAChB,uBAAuB,GACvB,aAAa,GACb,aAAa,GACb,eAAe,GACf,qBAAqB,CAAC;AAE5B,qBAAa,aAAc,SAAQ,KAAK;IACpC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;gBACrB,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM;CAKvD;AAWD;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CACtC,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACjB,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAwFjE;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAgBzF;AAID;;;GAGG;AACH,wBAAgB,sBAAsB,CAClC,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,EACjC,gBAAgB,CAAC,EAAE,MAAM,GAC1B;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,QAAQ,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAKjE;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACtC,IAAI,EAAE,UAAU,EAChB,SAAS,CAAC,EAAE,MAAM,GACnB;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,mBAAmB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CA8B9F;AAID,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,CAAC,EAAE,qBAAqB,GAAG,YAAY,CAkKjG"}