@zhin.js/adapter-kook 1.0.50 → 1.0.52

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @zhin.js/adapter-kook
 
+## 1.0.52
+
+### Patch Changes
+
+- zhin.js@1.0.51
+- @zhin.js/logger@0.1.35
+
+## 1.0.51
+
+### Patch Changes
+
+- zhin.js@1.0.50
+- @zhin.js/logger@0.1.34
+
 ## 1.0.50
 
 ### Patch Changes

package/lib/adapter.d.ts

@@ -0,0 +1,34 @@
+/**
+ * KOOK 适配器
+ */
+import { Adapter, Plugin } from "zhin.js";
+import { KookBot } from "./bot.js";
+import type { KookBotConfig } from "./types.js";
+export declare class KookAdapter extends Adapter<KookBot> {
+    constructor(plugin: Plugin);
+    createBot(config: KookBotConfig): KookBot;
+    kickMember(botId: string, sceneId: string, userId: string): Promise<boolean>;
+    banMember(botId: string, sceneId: string, userId: string, reason?: string): Promise<boolean>;
+    unbanMember(botId: string, sceneId: string, userId: string): Promise<boolean>;
+    setMemberNickname(botId: string, sceneId: string, userId: string, nickname: string): Promise<boolean>;
+    listMembers(botId: string, sceneId: string): Promise<{
+        members: {
+            id: string;
+            username: string;
+            nickname: string;
+            roles: number[];
+        }[];
+        count: number;
+    }>;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    /**
+     * 注册 KOOK 平台特有工具（角色授予等）
+     */
+    private registerKookPlatformTools;
+    /**
+     * 检查执行上下文中的权限
+     */
+    private checkPermission;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/lib/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EACL,OAAO,EACP,MAAM,EAMP,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACnC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGhD,qBAAa,WAAY,SAAQ,OAAO,CAAC,OAAO,CAAC;gBACnC,MAAM,EAAE,MAAM;IAI1B,SAAS,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO;IAMnC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAMzD,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;IAMzE,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAM1D,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;IAMlF,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;;;;;;;;;IAe1C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IActB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAK3B;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAqPjC;;OAEG;IACH,OAAO,CAAC,eAAe;CA8BxB"}

package/lib/adapter.js

@@ -0,0 +1,337 @@
+/**
+ * KOOK 适配器
+ */
+import { Adapter, createGroupManagementTools, GROUP_MANAGEMENT_SKILL_KEYWORDS, GROUP_MANAGEMENT_SKILL_TAGS, } from "zhin.js";
+import { KookBot } from "./bot.js";
+import { KookPermission } from "./types.js";
+export class KookAdapter extends Adapter {
+    constructor(plugin) {
+        super(plugin, "kook", []);
+    }
+    createBot(config) {
+        return new KookBot(this, config);
+    }
+    // ── IGroupManagement 标准群管方法 ──────────────────────────────────
+    async kickMember(botId, sceneId, userId) {
+        const bot = this.bots.get(botId);
+        if (!bot)
+            throw new Error(`Bot ${botId} 不存在`);
+        return bot.kickUser(sceneId, userId);
+    }
+    async banMember(botId, sceneId, userId, reason) {
+        const bot = this.bots.get(botId);
+        if (!bot)
+            throw new Error(`Bot ${botId} 不存在`);
+        return bot.addToBlacklist(sceneId, userId, reason);
+    }
+    async unbanMember(botId, sceneId, userId) {
+        const bot = this.bots.get(botId);
+        if (!bot)
+            throw new Error(`Bot ${botId} 不存在`);
+        return bot.removeFromBlacklist(sceneId, userId);
+    }
+    async setMemberNickname(botId, sceneId, userId, nickname) {
+        const bot = this.bots.get(botId);
+        if (!bot)
+            throw new Error(`Bot ${botId} 不存在`);
+        return bot.setNickname(sceneId, userId, nickname);
+    }
+    async listMembers(botId, sceneId) {
+        const bot = this.bots.get(botId);
+        if (!bot)
+            throw new Error(`Bot ${botId} 不存在`);
+        const members = await bot.getGuildMembers(sceneId);
+        return {
+            members: members.map(m => ({
+                id: m.id, username: m.username,
+                nickname: m.nickname, roles: m.roles,
+            })),
+            count: members.length,
+        };
+    }
+    // ── 生命周期 ───────────────────────────────────────────────────────
+    async start() {
+        this.registerKookPlatformTools();
+        const groupTools = createGroupManagementTools(this, this.name);
+        groupTools.forEach((t) => this.addTool(t));
+        this.declareSkill({
+            description: 'KOOK 服务器/频道群管理：踢人、禁言、封禁、设管理员、改服务器名、查成员等。仅昵称时请先 list_members 获取 user_id。',
+            keywords: GROUP_MANAGEMENT_SKILL_KEYWORDS,
+            tags: GROUP_MANAGEMENT_SKILL_TAGS,
+        });
+        await super.start();
+        this.plugin.logger.info("KOOK 适配器已启动");
+    }
+    async stop() {
+        await super.stop();
+        this.plugin.logger.info("KOOK 适配器已停止");
+    }
+    /**
+     * 注册 KOOK 平台特有工具（角色授予等）
+     */
+    registerKookPlatformTools() {
+        // 角色管理工具 - 授予角色
+        this.addTool({
+            name: 'kook_grant_role',
+            description: '给用户授予 KOOK 服务器角色',
+            parameters: {
+                type: 'object',
+                properties: {
+                    bot: {
+                        type: 'string',
+                        description: 'Bot 名称',
+                    },
+                    guild_id: {
+                        type: 'string',
+                        description: '服务器 ID',
+                    },
+                    user_id: {
+                        type: 'string',
+                        description: '用户 ID',
+                    },
+                    role_id: {
+                        type: 'string',
+                        description: '角色 ID',
+                    },
+                },
+                required: ['bot', 'guild_id', 'user_id', 'role_id'],
+            },
+            platforms: ['kook'],
+            scopes: ['channel'],
+            permissionLevel: 'group_admin',
+            execute: async (args, context) => {
+                const { bot: botId, guild_id, user_id, role_id } = args;
+                const bot = this.bots.get(botId);
+                if (!bot)
+                    throw new Error(`Bot ${botId} 不存在`);
+                this.checkPermission(context, 'group_admin');
+                const success = await bot.grantRole(guild_id, user_id, role_id);
+                return { success, message: success ? `已授予用户 ${user_id} 角色 ${role_id}` : '授予角色失败' };
+            },
+        });
+        // 角色管理工具 - 撤销角色
+        this.addTool({
+            name: 'kook_revoke_role',
+            description: '撤销用户的 KOOK 服务器角色',
+            parameters: {
+                type: 'object',
+                properties: {
+                    bot: {
+                        type: 'string',
+                        description: 'Bot 名称',
+                    },
+                    guild_id: {
+                        type: 'string',
+                        description: '服务器 ID',
+                    },
+                    user_id: {
+                        type: 'string',
+                        description: '用户 ID',
+                    },
+                    role_id: {
+                        type: 'string',
+                        description: '角色 ID',
+                    },
+                },
+                required: ['bot', 'guild_id', 'user_id', 'role_id'],
+            },
+            platforms: ['kook'],
+            scopes: ['channel'],
+            permissionLevel: 'group_admin',
+            execute: async (args, context) => {
+                const { bot: botId, guild_id, user_id, role_id } = args;
+                const bot = this.bots.get(botId);
+                if (!bot)
+                    throw new Error(`Bot ${botId} 不存在`);
+                this.checkPermission(context, 'group_admin');
+                const success = await bot.revokeRole(guild_id, user_id, role_id);
+                return { success, message: success ? `已撤销用户 ${user_id} 的角色 ${role_id}` : '撤销角色失败' };
+            },
+        });
+        // 获取角色列表工具
+        this.addTool({
+            name: 'kook_list_roles',
+            description: '获取 KOOK 服务器的角色列表',
+            parameters: {
+                type: 'object',
+                properties: {
+                    bot: {
+                        type: 'string',
+                        description: 'Bot 名称',
+                    },
+                    guild_id: {
+                        type: 'string',
+                        description: '服务器 ID',
+                    },
+                },
+                required: ['bot', 'guild_id'],
+            },
+            platforms: ['kook'],
+            scopes: ['channel'],
+            permissionLevel: 'user', // 普通用户可查看
+            execute: async (args) => {
+                const { bot: botId, guild_id } = args;
+                const bot = this.bots.get(botId);
+                if (!bot)
+                    throw new Error(`Bot ${botId} 不存在`);
+                const roles = await bot.getRoleList(guild_id);
+                return {
+                    roles: roles.map(r => ({
+                        id: r.role_id,
+                        name: r.name,
+                        color: r.color,
+                        position: r.position,
+                        permissions: r.permissions,
+                    })),
+                    count: roles.length,
+                };
+            },
+        });
+        // 创建角色工具
+        this.addTool({
+            name: 'kook_create_role',
+            description: '在 KOOK 服务器中创建新角色（需要服务器主人权限）',
+            parameters: {
+                type: 'object',
+                properties: {
+                    bot: {
+                        type: 'string',
+                        description: 'Bot 名称',
+                    },
+                    guild_id: {
+                        type: 'string',
+                        description: '服务器 ID',
+                    },
+                    name: {
+                        type: 'string',
+                        description: '角色名称',
+                    },
+                },
+                required: ['bot', 'guild_id', 'name'],
+            },
+            platforms: ['kook'],
+            scopes: ['channel'],
+            permissionLevel: 'group_owner',
+            execute: async (args, context) => {
+                const { bot: botId, guild_id, name } = args;
+                const bot = this.bots.get(botId);
+                if (!bot)
+                    throw new Error(`Bot ${botId} 不存在`);
+                this.checkPermission(context, 'group_owner');
+                const role = await bot.createRole(guild_id, name);
+                return {
+                    success: true,
+                    message: `已创建角色 "${name}"`,
+                    role: {
+                        id: role.role_id,
+                        name: role.name,
+                    },
+                };
+            },
+        });
+        // 删除角色工具
+        this.addTool({
+            name: 'kook_delete_role',
+            description: '删除 KOOK 服务器中的角色（需要服务器主人权限）',
+            parameters: {
+                type: 'object',
+                properties: {
+                    bot: {
+                        type: 'string',
+                        description: 'Bot 名称',
+                    },
+                    guild_id: {
+                        type: 'string',
+                        description: '服务器 ID',
+                    },
+                    role_id: {
+                        type: 'string',
+                        description: '角色 ID',
+                    },
+                },
+                required: ['bot', 'guild_id', 'role_id'],
+            },
+            platforms: ['kook'],
+            scopes: ['channel'],
+            permissionLevel: 'group_owner',
+            execute: async (args, context) => {
+                const { bot: botId, guild_id, role_id } = args;
+                const bot = this.bots.get(botId);
+                if (!bot)
+                    throw new Error(`Bot ${botId} 不存在`);
+                this.checkPermission(context, 'group_owner');
+                const success = await bot.deleteRole(guild_id, role_id);
+                return { success, message: success ? `已删除角色 ${role_id}` : '删除角色失败' };
+            },
+        });
+        // 黑名单管理（仅支持 add/remove，通过 GuildMember API）
+        this.addTool({
+            name: 'kook_blacklist',
+            description: 'KOOK 服务器黑名单管理：添加/移除',
+            parameters: {
+                type: 'object',
+                properties: {
+                    bot: { type: 'string', description: 'Bot 名称' },
+                    guild_id: { type: 'string', description: '服务器 ID' },
+                    action: { type: 'string', description: 'add|remove', enum: ['add', 'remove'] },
+                    user_id: { type: 'string', description: '用户 ID' },
+                    remark: { type: 'string', description: '备注（add 可选）' },
+                },
+                required: ['bot', 'guild_id', 'action', 'user_id'],
+            },
+            platforms: ['kook'],
+            scopes: ['channel'],
+            permissionLevel: 'group_admin',
+            execute: async (args, context) => {
+                const { bot: botId, guild_id, action, user_id, remark } = args;
+                const bot = this.bots.get(botId);
+                if (!bot)
+                    throw new Error(`Bot ${botId} 不存在`);
+                this.checkPermission(context, 'group_admin');
+                switch (action) {
+                    case 'add': {
+                        const success = await bot.addToBlacklist(guild_id, user_id, remark);
+                        return { success, message: success ? `已将 ${user_id} 加入黑名单` : '操作失败' };
+                    }
+                    case 'remove': {
+                        const success = await bot.removeFromBlacklist(guild_id, user_id);
+                        return { success, message: success ? `已将 ${user_id} 从黑名单移除` : '操作失败' };
+                    }
+                    default: return { success: false, message: `未知操作: ${action}` };
+                }
+            },
+        });
+        this.plugin.logger.debug('已注册 KOOK 平台管理工具');
+    }
+    /**
+     * 检查执行上下文中的权限
+     */
+    checkPermission(context, required) {
+        if (!context?.message)
+            return; // 无上下文时跳过检查（命令行调用）
+        const sender = context.message.$sender;
+        if (!sender)
+            return;
+        const permissionLevels = {
+            'user': 0,
+            'group_admin': 1,
+            'group_owner': 2,
+            'bot_admin': 3,
+            'owner': 4,
+        };
+        // 获取发送者的实际权限级别
+        let senderLevel = 'user';
+        if (sender.isGuildOwner || sender.permission === KookPermission.Owner) {
+            senderLevel = 'group_owner';
+        }
+        else if (sender.isAdmin || sender.permission === KookPermission.Admin ||
+            sender.permission === KookPermission.ChannelAdmin) {
+            senderLevel = 'group_admin';
+        }
+        // TODO: 检查是否为 bot_admin 或 owner（需要从 zhin 配置中获取）
+        if (permissionLevels[senderLevel] < permissionLevels[required]) {
+            throw new Error(`权限不足：需要 ${required} 权限，当前为 ${senderLevel}`);
+        }
+    }
+}
+//# sourceMappingURL=adapter.js.map

package/lib/adapter.js.map

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

package/lib/bot.d.ts

@@ -0,0 +1,122 @@
+/**
+ * KOOK Bot 实现
+ */
+import { Client, User, Guild } from "kook-client";
+import { Bot, Message, SendOptions } from "zhin.js";
+import type { KookBotConfig, KookRawMessage } from "./types.js";
+import type { KookAdapter } from "./adapter.js";
+export declare class KookBot extends Client implements Bot<KookBotConfig, KookRawMessage> {
+    $config: KookBotConfig;
+    $connected: boolean;
+    adapter: KookAdapter;
+    get $id(): string;
+    get pluginLogger(): import("zhin.js").Logger;
+    constructor(adapter: KookAdapter, $config: KookBotConfig);
+    /**
+     * 设置事件监听器
+     */
+    private setupEventListeners;
+    /**
+     * 将 KOOK 消息转换为标准消息格式
+     */
+    $formatMessage(msg: KookRawMessage): Message<KookRawMessage>;
+    /**
+     * 获取发送者的详细权限信息
+     */
+    private getSenderInfo;
+    /**
+     * 踢出用户
+     * @param guildId 服务器ID
+     * @param userId 用户ID
+     */
+    kickUser(guildId: string, userId: string): Promise<boolean>;
+    /**
+     * 将用户加入黑名单
+     * @param guildId 服务器ID
+     * @param userId 用户ID
+     * @param remark 备注
+     * @param delMsgDays 删除消息天数（0-7）
+     */
+    addToBlacklist(guildId: string, userId: string, remark?: string, delMsgDays?: number): Promise<boolean>;
+    /**
+     * 将用户从黑名单移除
+     * @param guildId 服务器ID
+     * @param userId 用户ID
+     */
+    removeFromBlacklist(guildId: string, userId: string): Promise<boolean>;
+    /**
+     * 给用户授予角色
+     * @param guildId 服务器ID
+     * @param userId 用户ID
+     * @param roleId 角色ID
+     */
+    grantRole(guildId: string, userId: string, roleId: string): Promise<boolean>;
+    /**
+     * 撤销用户角色
+     * @param guildId 服务器ID
+     * @param userId 用户ID
+     * @param roleId 角色ID
+     */
+    revokeRole(guildId: string, userId: string, roleId: string): Promise<boolean>;
+    /**
+     * 设置用户昵称
+     * @param guildId 服务器ID
+     * @param userId 用户ID
+     * @param nickname 新昵称
+     */
+    setNickname(guildId: string, userId: string, nickname: string): Promise<boolean>;
+    /**
+     * 获取服务器角色列表
+     * @param guildId 服务器ID
+     */
+    getRoleList(guildId: string): Promise<Guild.Role[]>;
+    /**
+     * 创建角色
+     * @param guildId 服务器ID
+     * @param name 角色名称
+     */
+    createRole(guildId: string, name: string): Promise<Guild.Role>;
+    /**
+     * 删除角色
+     * @param guildId 服务器ID
+     * @param roleId 角色ID
+     */
+    deleteRole(guildId: string, roleId: string): Promise<boolean>;
+    /**
+     * 获取服务器成员列表
+     * @param guildId 服务器ID
+     * @param channelId 可选的频道ID
+     */
+    getGuildMembers(guildId: string, channelId?: string): Promise<User.Info[]>;
+    private parseMarkdown;
+    /**
+     * 将 kook-client 的 MessageSegment[] 转换为 Zhin 的 MessageElement[]
+     */
+    private parseMessageContent;
+    /**
+     * 检查文本是否包含 KMarkdown 特殊语法
+     */
+    private hasKMarkdownSyntax;
+    /**
+     * 连接到 KOOK
+     */
+    $connect(): Promise<void>;
+    /**
+   * 断开连接
+   */
+    $disconnect(): Promise<void>;
+    /**
+   * 发送消息
+   */
+    $sendMessage(options: SendOptions): Promise<string>;
+    /**
+   * 撤回消息
+     */
+    $recallMessage(messageId: string): Promise<void>;
+    /**
+   * 将消息段转换为 KOOK KMarkdown 格式
+   * 支持：文本、图片、@提及、表情、引用等
+   */
+    private convertToKookFormat;
+}
+//# sourceMappingURL=bot.d.ts.map

package/lib/bot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bot.d.ts","sourceRoot":"","sources":["../src/bot.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EACL,MAAM,EAIN,IAAI,EACJ,KAAK,EAGN,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,GAAG,EACH,OAAO,EACP,WAAW,EAKZ,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,aAAa,EAAkB,cAAc,EAAE,MAAM,YAAY,CAAC;AAEhF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,qBAAa,OAAQ,SAAQ,MAAO,YAAW,GAAG,CAAC,aAAa,EAAE,cAAc,CAAC;IAYtC,OAAO,EAAE,aAAa;IAX/D,UAAU,EAAE,OAAO,CAAS;IAC5B,OAAO,EAAE,WAAW,CAAC;IAErB,IAAI,GAAG,IAAI,MAAM,CAEhB;IAED,IAAI,YAAY,6BAEf;gBAEW,OAAO,EAAE,WAAW,EAAS,OAAO,EAAE,aAAa;IAc/D;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA0C3B;;OAEG;IACH,cAAc,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IAwE5D;;OAEG;IACH,OAAO,CAAC,aAAa;IA+CrB;;;;OAIG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAYjE;;;;;;OAMG;IACG,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAY7G;;;;OAIG;IACG,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAY5E;;;;;OAKG;IACG,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAYlF;;;;;OAKG;IACG,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAYnF;;;;;OAKG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAYtF;;;OAGG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IAUzD;;;;OAIG;IACG,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC;IAYpE;;;;OAIG;IACG,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAYnE;;;;OAIG;IACG,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IAQhF,OAAO,CAAC,aAAa;IAsFrB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA8D3B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAI1B;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAW/B;;KAEC;IACK,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAWlC;;KAEC;IACK,YAAY,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IA0BzD;;OAEG;IACG,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUtD;;;KAGC;IACD,OAAO,CAAC,mBAAmB;CAoE5B"}