@downcity/plugins 1.0.4

package/bin/chat/types/FeishuPost.d.ts

@@ -0,0 +1,287 @@
+/**
+ * Feishu `post` 富文本消息类型定义。
+ *
+ * 关键点（中文）
+ * - 统一描述飞书 `msg_type=post` 的核心结构，供入站解析与出站构建复用。
+ * - 这里只保留当前 chat channel 真正会消费的字段，避免把平台超大 schema 整体引入运行时。
+ */
+/**
+ * Feishu `post` 语言块 key。
+ *
+ * 说明（中文）
+ * - 飞书常见语言块为 `zh_cn` / `en_us` / `ja_jp`。
+ * - 为了兼容未来新增 locale，这里保留 `string` 兜底。
+ */
+export type FeishuPostLocaleKey = "zh_cn" | "en_us" | "ja_jp" | "zh_hk" | "zh_tw" | string;
+/**
+ * Feishu `post` 顶层 payload。
+ */
+export interface FeishuPostPayload {
+    /**
+     * 语言块映射。
+     *
+     * 说明（中文）
+     * - key 为 locale。
+     * - value 为该语言对应的标题与内容。
+     */
+    [locale: string]: FeishuPostLocaleContent | unknown;
+}
+/**
+ * 单个 locale 下的富文本内容。
+ */
+export interface FeishuPostLocaleContent {
+    /**
+     * 富文本标题。
+     *
+     * 说明（中文）
+     * - 可为空字符串。
+     * - 入站解析时会作为正文前缀保留。
+     */
+    title?: string;
+    /**
+     * 富文本正文二维数组。
+     *
+     * 说明（中文）
+     * - 第一维表示“段/行”。
+     * - 第二维表示这一行中的富文本节点序列。
+     */
+    content?: FeishuPostParagraph[];
+}
+/**
+ * 一行富文本节点列表。
+ */
+export type FeishuPostParagraph = FeishuPostElement[];
+/**
+ * Feishu `post` 支持的节点联合。
+ *
+ * 说明（中文）
+ * - 当前覆盖文本、链接、提及、图片、媒体、表情、分割线等常见节点。
+ * - 未识别节点会在运行时按兜底策略处理，不依赖这里声明全部平台字段。
+ */
+export type FeishuPostElement = FeishuPostTextElement | FeishuPostLinkElement | FeishuPostMentionElement | FeishuPostImageElement | FeishuPostMediaElement | FeishuPostEmotionElement | FeishuPostHrElement | FeishuPostUnknownElement;
+/**
+ * 文本节点。
+ */
+export interface FeishuPostTextElement {
+    /**
+     * 节点类型。
+     */
+    tag: "text";
+    /**
+     * 文本内容。
+     *
+     * 说明（中文）
+     * - 出站时直接显示给用户。
+     * - 入站时会被拼接回自然语言正文。
+     */
+    text: string;
+    /**
+     * 是否对特殊字符做转义控制。
+     *
+     * 说明（中文）
+     * - 飞书 `post` 会携带该字段。
+     * - 当前 runtime 不依赖该值做逻辑判断，仅做结构兼容保留。
+     */
+    un_escape?: boolean;
+    /**
+     * 文本样式集合。
+     *
+     * 说明（中文）
+     * - 如 `bold` / `underline` / `lineThrough` / `italic`。
+     * - 当前仅透传兼容，不参与 runtime 主逻辑。
+     */
+    style?: string[];
+}
+/**
+ * 超链接节点。
+ */
+export interface FeishuPostLinkElement {
+    /**
+     * 节点类型。
+     */
+    tag: "a";
+    /**
+     * 链接展示文本。
+     */
+    text: string;
+    /**
+     * 链接目标地址。
+     */
+    href: string;
+    /**
+     * 可选文本样式集合。
+     */
+    style?: string[];
+}
+/**
+ * @提及节点。
+ */
+export interface FeishuPostMentionElement {
+    /**
+     * 节点类型。
+     */
+    tag: "at";
+    /**
+     * 被提及用户 ID。
+     *
+     * 说明（中文）
+     * - 可能是 `open_id` / `user_id`。
+     * - `all` 场景通常不依赖该字段。
+     */
+    user_id?: string;
+    /**
+     * 被提及用户展示名。
+     *
+     * 说明（中文）
+     * - 入站解析时优先使用该字段生成 `@用户名`。
+     */
+    user_name?: string;
+}
+/**
+ * 图片节点。
+ */
+export interface FeishuPostImageElement {
+    /**
+     * 节点类型。
+     */
+    tag: "img";
+    /**
+     * 飞书图片资源 key。
+     *
+     * 说明（中文）
+     * - 入站时用于下载消息内图片。
+     * - 出站时由图片上传接口返回。
+     */
+    image_key: string;
+    /**
+     * 可选替代文本。
+     *
+     * 说明（中文）
+     * - 平台不会总是返回该字段。
+     * - 当前主要用于生成更友好的文本占位与附件描述。
+     */
+    alt?: string;
+}
+/**
+ * 媒体节点。
+ */
+export interface FeishuPostMediaElement {
+    /**
+     * 节点类型。
+     *
+     * 说明（中文）
+     * - 部分 payload 可能使用 `media` / `file` / `audio` / `video`。
+     */
+    tag: "media" | "file" | "audio" | "video";
+    /**
+     * 飞书文件资源 key。
+     *
+     * 说明（中文）
+     * - 当前主要用于下载视频/文件/音频资源。
+     */
+    file_key?: string;
+    /**
+     * 可选预览图 key。
+     */
+    image_key?: string;
+    /**
+     * 可选文件名。
+     */
+    file_name?: string;
+    /**
+     * 可选标题。
+     */
+    title?: string;
+    /**
+     * 可选时长（秒）。
+     */
+    duration?: number;
+}
+/**
+ * 表情节点。
+ */
+export interface FeishuPostEmotionElement {
+    /**
+     * 节点类型。
+     */
+    tag: "emotion";
+    /**
+     * 表情类型标识。
+     *
+     * 说明（中文）
+     * - 当前入站会退化成可读文本占位，例如 `[表情:smile]`。
+     */
+    emoji_type?: string;
+}
+/**
+ * 分割线节点。
+ */
+export interface FeishuPostHrElement {
+    /**
+     * 节点类型。
+     */
+    tag: "hr";
+}
+/**
+ * 未知节点兜底结构。
+ */
+export interface FeishuPostUnknownElement {
+    /**
+     * 节点类型原文。
+     *
+     * 说明（中文）
+     * - 当平台新增新节点时，运行时仍可通过该字段做兜底处理。
+     */
+    tag: string;
+    /**
+     * 节点原始文本。
+     *
+     * 说明（中文）
+     * - 并非所有未知节点都有该字段。
+     * - 当前仅在兜底拼接正文时 best-effort 使用。
+     */
+    text?: string;
+    /**
+     * 节点原始标题。
+     */
+    title?: string;
+    /**
+     * 节点原始链接。
+     */
+    href?: string;
+    /**
+     * 节点原始图片 key。
+     */
+    image_key?: string;
+    /**
+     * 节点原始文件 key。
+     */
+    file_key?: string;
+    /**
+     * 其他平台字段。
+     *
+     * 说明（中文）
+     * - 保留开放形态，避免 schema 漂移导致类型过度僵化。
+     */
+    [key: string]: unknown;
+}
+/**
+ * 出站 `post` 内联图片描述。
+ */
+export interface FeishuPostInlineImage {
+    /**
+     * 飞书图片 key。
+     *
+     * 说明（中文）
+     * - 由 `im/v1/images` 上传接口返回。
+     */
+    imageKey: string;
+    /**
+     * 可选图片说明。
+     *
+     * 说明（中文）
+     * - 当前会在图片下一行追加为普通文本。
+     */
+    caption?: string;
+}
+//# sourceMappingURL=FeishuPost.d.ts.map

package/bin/chat/types/FeishuPost.d.ts.map

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

package/bin/chat/types/FeishuPost.js

@@ -0,0 +1,9 @@
+/**
+ * Feishu `post` 富文本消息类型定义。
+ *
+ * 关键点（中文）
+ * - 统一描述飞书 `msg_type=post` 的核心结构，供入站解析与出站构建复用。
+ * - 这里只保留当前 chat channel 真正会消费的字段，避免把平台超大 schema 整体引入运行时。
+ */
+export {};
+//# sourceMappingURL=FeishuPost.js.map

package/bin/chat/types/FeishuPost.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FeishuPost.js","sourceRoot":"","sources":["../../../src/chat/types/FeishuPost.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/bin/chat/types/QqInboundDedupe.d.ts

@@ -0,0 +1,12 @@
+/**
+ * QQ 入站去重快照类型。
+ *
+ * 关键点（中文）
+ * - 持久化到本地 JSON 文件，用于重启后去重。
+ */
+export interface QqInboundDedupeSnapshotV1 {
+    v: 1;
+    updatedAt: number;
+    ids: string[];
+}
+//# sourceMappingURL=QqInboundDedupe.d.ts.map

package/bin/chat/types/QqInboundDedupe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QqInboundDedupe.d.ts","sourceRoot":"","sources":["../../../src/chat/types/QqInboundDedupe.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,yBAAyB;IACxC,CAAC,EAAE,CAAC,CAAC;IACL,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,EAAE,CAAC;CACf"}

package/bin/chat/types/QqInboundDedupe.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=QqInboundDedupe.js.map

package/bin/chat/types/QqInboundDedupe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QqInboundDedupe.js","sourceRoot":"","sources":["../../../src/chat/types/QqInboundDedupe.ts"],"names":[],"mappings":""}

package/bin/chat/types/QqVoice.d.ts

@@ -0,0 +1,118 @@
+/**
+ * QQ 语音/附件处理相关类型。
+ *
+ * 关键点（中文）
+ * - 统一描述 QQ 入站附件的“原始形态”与“归一化形态”。
+ * - 仅覆盖 chat 语音转写链路所需字段，避免过度耦合平台全量 schema。
+ */
+/**
+ * QQ 网关消息中的原始附件对象（宽松字段集合）。
+ *
+ * 说明（中文）
+ * - QQ 不同事件类型/权限集返回字段存在差异，本类型使用“可选 + 宽松”的兼容策略。
+ * - 未列出的字段可通过索引签名继续透传，供调试与后续扩展。
+ */
+export interface QqRawInboundAttachment {
+    /**
+     * 附件唯一标识（可能是 `id`、`file_id`、`media_id` 等）。
+     */
+    id?: string;
+    /**
+     * 文件标识（平台侧文件 ID）。
+     */
+    file_id?: string;
+    /**
+     * 附件文件名（如 `voice.ogg`）。
+     */
+    filename?: string;
+    /**
+     * 备用文件名字段（部分 payload 使用下划线命名）。
+     */
+    file_name?: string;
+    /**
+     * MIME 类型（如 `audio/ogg`）。
+     */
+    content_type?: string;
+    /**
+     * 备用 MIME 字段（如 `mime_type`）。
+     */
+    mime_type?: string;
+    /**
+     * 下载地址（标准 URL 字段）。
+     */
+    url?: string;
+    /**
+     * 备用下载地址字段。
+     */
+    download_url?: string;
+    /**
+     * 文件地址字段（部分 payload 使用）。
+     */
+    file_url?: string;
+    /**
+     * 音频地址字段（部分 payload 使用）。
+     */
+    audio_url?: string;
+    /**
+     * 语音地址字段（部分 payload 使用）。
+     */
+    voice_url?: string;
+    /**
+     * 媒体类型（如 `audio` / `image` / `video`）。
+     */
+    media_type?: string;
+    /**
+     * 附件类型（宽松字符串，可能与 `media_type` 重复）。
+     */
+    type?: string;
+    /**
+     * 附件大小（字节）。
+     */
+    size?: number;
+    /**
+     * 允许透传未知字段，避免在 schema 演进时丢信息。
+     */
+    [key: string]: unknown;
+}
+/**
+ * QQ 附件归一化后的类型枚举。
+ */
+export type QqInboundAttachmentKind = "voice" | "audio" | "photo" | "video" | "document" | "unknown";
+/**
+ * QQ 入站附件归一化结构。
+ *
+ * 说明（中文）
+ * - `raw` 保留平台原始对象，便于日志与排障。
+ * - `localPath` 在附件已落地时可直接用于转写。
+ */
+export interface QqIncomingAttachment {
+    /**
+     * 归一化后的附件类型。
+     */
+    kind: QqInboundAttachmentKind;
+    /**
+     * 原始附件对象。
+     */
+    raw: QqRawInboundAttachment;
+    /**
+     * 附件 ID（若可解析）。
+     */
+    attachmentId?: string;
+    /**
+     * 附件文件名（若可解析）。
+     */
+    fileName?: string;
+    /**
+     * MIME 类型（若可解析）。
+     */
+    contentType?: string;
+    /**
+     * 可下载 URL（若可解析）。
+     */
+    url?: string;
+    /**
+     * 附件本地绝对路径（若已存在）。
+     */
+    localPath?: string;
+}
+//# sourceMappingURL=QqVoice.d.ts.map

package/bin/chat/types/QqVoice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QqVoice.d.ts","sourceRoot":"","sources":["../../../src/chat/types/QqVoice.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;GAMG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAC/B,OAAO,GACP,OAAO,GACP,OAAO,GACP,OAAO,GACP,UAAU,GACV,SAAS,CAAC;AAEd;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,IAAI,EAAE,uBAAuB,CAAC;IAC9B;;OAEG;IACH,GAAG,EAAE,sBAAsB,CAAC;IAC5B;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/bin/chat/types/QqVoice.js

@@ -0,0 +1,9 @@
+/**
+ * QQ 语音/附件处理相关类型。
+ *
+ * 关键点（中文）
+ * - 统一描述 QQ 入站附件的“原始形态”与“归一化形态”。
+ * - 仅覆盖 chat 语音转写链路所需字段，避免过度耦合平台全量 schema。
+ */
+export {};
+//# sourceMappingURL=QqVoice.js.map

package/bin/chat/types/QqVoice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QqVoice.js","sourceRoot":"","sources":["../../../src/chat/types/QqVoice.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/bin/chat/types/ReplyContext.d.ts

@@ -0,0 +1,46 @@
+/**
+ * ReplyContext：入站 reply / 引用消息上下文。
+ *
+ * 关键点（中文）
+ * - 统一描述“当前消息所引用的上一条消息”。
+ * - 供 Telegram / Feishu / 未来其他渠道复用。
+ * - 该结构只表达模型真正需要的引用信息，不绑定具体平台原始 payload。
+ */
+/**
+ * 归一化后的入站引用上下文。
+ */
+export interface InboundReplyContext {
+    /**
+     * 被引用消息的消息 ID。
+     *
+     * 说明（中文）
+     * - 该值来自平台原始 reply 目标。
+     * - 主要用于审计与调试，模型通常不会直接依赖它做推理。
+     */
+    messageId?: string;
+    /**
+     * 被引用消息发送者的展示名。
+     *
+     * 说明（中文）
+     * - 若平台未提供姓名，则允许为空。
+     * - 该字段用于帮助模型理解“这条被引用消息是谁说的”。
+     */
+    actorName?: string;
+    /**
+     * 被引用消息的归一化正文。
+     *
+     * 说明（中文）
+     * - 文本消息时保存原始正文。
+     * - 附件或无法直接展开的消息，会保存稳定的占位描述。
+     */
+    text?: string;
+    /**
+     * 用户显式框选的引用片段。
+     *
+     * 说明（中文）
+     * - 仅部分平台支持“回复时引用一小段内容”。
+     * - 若存在，该字段优先表达用户本次真正关注的局部内容。
+     */
+    quoteText?: string;
+}
+//# sourceMappingURL=ReplyContext.d.ts.map

package/bin/chat/types/ReplyContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReplyContext.d.ts","sourceRoot":"","sources":["../../../src/chat/types/ReplyContext.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/bin/chat/types/ReplyContext.js

@@ -0,0 +1,10 @@
+/**
+ * ReplyContext：入站 reply / 引用消息上下文。
+ *
+ * 关键点（中文）
+ * - 统一描述“当前消息所引用的上一条消息”。
+ * - 供 Telegram / Feishu / 未来其他渠道复用。
+ * - 该结构只表达模型真正需要的引用信息，不绑定具体平台原始 payload。
+ */
+export {};
+//# sourceMappingURL=ReplyContext.js.map

package/bin/chat/types/ReplyContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReplyContext.js","sourceRoot":"","sources":["../../../src/chat/types/ReplyContext.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/bin/contact/Action.d.ts

@@ -0,0 +1,62 @@
+/**
+ * contact action 注册表。
+ *
+ * 关键点（中文）
+ * - 这里只负责 CLI action 与内部远端 command action 映射，不承载 contact 业务实现。
+ * - 业务动作通过 handlers 注入，保持 `ContactPlugin` 类本身更薄。
+ */
+import type { AgentContext } from "@downcity/agent/internal/types/runtime/agent/AgentContext.js";
+import type { JsonValue } from "@downcity/agent/internal/types/common/Json.js";
+import type { PluginActions } from "@downcity/agent/internal/plugin/types/Plugin.js";
+import type { ContactApproveCommandPayload, ContactChatCommandPayload, ContactCheckCommandPayload, ContactLinkCommandPayload, ContactShareCommandPayload } from "../contact/types/ContactCommand.js";
+import type { ContactApproveLinkRequest, ContactApproveLinkResponse } from "../contact/types/ContactLink.js";
+import type { ContactConfirmRequest, ContactConfirmResponse } from "../contact/types/ContactApproval.js";
+import type { ContactPingResponse } from "../contact/types/ContactCheck.js";
+/**
+ * ContactPlugin 注入给 action 注册表的业务动作。
+ */
+export type ContactActionHandlers = {
+    /**
+     * 生成一次性联系码。
+     */
+    link: (context: AgentContext, payload: ContactLinkCommandPayload) => Promise<JsonValue>;
+    /**
+     * 使用联系码建立 contact。
+     */
+    approve: (context: AgentContext, payload: ContactApproveCommandPayload) => Promise<JsonValue>;
+    /**
+     * 检查 contact 或 endpoint 可用性。
+     */
+    check: (context: AgentContext, payload: ContactCheckCommandPayload) => Promise<JsonValue>;
+    /**
+     * 与 contact 对话或读取对话历史。
+     */
+    chat: (context: AgentContext, payload: ContactChatCommandPayload) => Promise<JsonValue>;
+    /**
+     * 向 contact 分享内容。
+     */
+    share: (context: AgentContext, payload: ContactShareCommandPayload) => Promise<JsonValue>;
+    /**
+     * 处理远端 ping 请求。
+     */
+    remotePing: (context: AgentContext, payload: {
+        token?: string;
+    }) => Promise<ContactPingResponse>;
+    /**
+     * 处理远端 approve 请求。
+     */
+    remoteApprove: (context: AgentContext, request: ContactApproveLinkRequest) => Promise<ContactApproveLinkResponse>;
+    /**
+     * 处理远端 confirm 请求。
+     */
+    remoteConfirm: (context: AgentContext, request: ContactConfirmRequest) => Promise<ContactConfirmResponse>;
+    /**
+     * 处理远端 share 请求。
+     */
+    remoteShare: (context: AgentContext, rawPayload: JsonValue) => Promise<JsonValue>;
+};
+/**
+ * 创建 contact plugin action 表。
+ */
+export declare function createContactActions(handlers: ContactActionHandlers): PluginActions;
+//# sourceMappingURL=Action.d.ts.map

package/bin/contact/Action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Action.d.ts","sourceRoot":"","sources":["../../src/contact/Action.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8DAA8D,CAAC;AACjG,OAAO,KAAK,EAAc,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAC3F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iDAAiD,CAAC;AACrF,OAAO,KAAK,EACV,4BAA4B,EAC5B,yBAAyB,EACzB,0BAA0B,EAC1B,yBAAyB,EAEzB,0BAA0B,EAC3B,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EACV,yBAAyB,EACzB,0BAA0B,EAC3B,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EACV,qBAAqB,EACrB,sBAAsB,EACvB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAU3E;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC;;OAEG;IACH,IAAI,EAAE,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,yBAAyB,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;IACxF;;OAEG;IACH,OAAO,EAAE,CACP,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,4BAA4B,KAClC,OAAO,CAAC,SAAS,CAAC,CAAC;IACxB;;OAEG;IACH,KAAK,EAAE,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,0BAA0B,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;IAC1F;;OAEG;IACH,IAAI,EAAE,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,yBAAyB,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;IACxF;;OAEG;IACH,KAAK,EAAE,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,0BAA0B,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;IAC1F;;OAEG;IACH,UAAU,EAAE,CACV,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,KACxB,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAClC;;OAEG;IACH,aAAa,EAAE,CACb,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,yBAAyB,KAC/B,OAAO,CAAC,0BAA0B,CAAC,CAAC;IACzC;;OAEG;IACH,aAAa,EAAE,CACb,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,qBAAqB,KAC3B,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACrC;;OAEG;IACH,WAAW,EAAE,CAAC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;CACnF,CAAC;AAEF;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,qBAAqB,GAAG,aAAa,CA6NnF"}