knight-agent 1.1.0

package/module/ReasonModule/TreeReason.js

@@ -0,0 +1,139 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TreeReason = void 0;
+const base_1 = require("../../base");
+/**
+ * 思维树推理策略 (Tree of Thoughts)
+ *   生成多个候选方案 → 评估择优 → 展开最佳方案
+ *   适合：方案设计、多方案对比、需要多角度探索的开放问题
+ *   策略内部自行创建/管理一个 Agent 贯穿全流程
+ */
+class TreeReason extends base_1.AbstractReason {
+    constructor() {
+        super(...arguments);
+        this.type = "TreeReason";
+        /** 候选分支数 */
+        this._branches = 3;
+    }
+    async execute(input, config) {
+        const agent = config.useAgent ?? this.host.agentModule.createAgent(config.baseConfig);
+        const runOptions = this.buildRunOptions(config);
+        try {
+            const trace = [];
+            // Phase 1: 生成多个候选方案
+            trace.push("[ToT Phase 1] 生成候选方案");
+            const genResult = await agent.run(`请针对以下问题，生成 ${this._branches} 个不同的解决方案。\n\n` +
+                `问题: ${input}\n\n` +
+                `请严格按以下格式输出:\n` +
+                `\`\`\`\n` +
+                `【方案 1】\n` +
+                `思路: (简要说明核心思路)\n` +
+                `方案: (详细方案)\n` +
+                `优劣: (优点和缺点)\n\n` +
+                `【方案 2】\n` +
+                `...\n` +
+                `\`\`\`\n\n` +
+                `要求:\n` +
+                `1. 每个方案应有不同的切入角度\n` +
+                `2. 每个方案应具体、可操作\n` +
+                `3. 客观分析各方案的优劣`, runOptions);
+            if (!genResult.success) {
+                return { ...genResult, strategy: this.type, trace };
+            }
+            const candidates = this._parseCandidates(genResult.content);
+            if (candidates.length === 0) {
+                trace.push("候选方案解析失败，降级为直接执行");
+                const fallback = await agent.run(`请直接回答: ${input}`, runOptions);
+                return { ...fallback, strategy: this.type, trace };
+            }
+            trace.push(`生成 ${candidates.length} 个候选方案`);
+            for (let i = 0; i < candidates.length; i++) {
+                trace.push(`  候选 ${i + 1}: ${candidates[i].summary}`);
+            }
+            // Phase 2: 评估并选择最佳方案
+            trace.push("[ToT Phase 2] 评估候选方案");
+            const evalPrompt = `以下是针对问题「${input}」的 ${candidates.length} 个候选方案:\n\n` +
+                candidates.map((c, i) => `【候选 ${i + 1}】\n${c.full}\n`).join("---\n\n") +
+                `\n请完成以下评估:\n` +
+                `1. 对每个候选方案打分（1-10 分）并简要说明理由\n` +
+                `2. 选出最佳方案并说明为什么\n` +
+                `3. 对最佳方案提出改进建议\n\n` +
+                `请按以下格式输出:\n` +
+                `评分:\n` +
+                `- 候选 1: X分 - (理由)\n` +
+                `- 候选 2: X分 - (理由)\n` +
+                `...\n` +
+                `最佳方案: 候选 X\n` +
+                `改进建议: (具体建议)`;
+            const evalResult = await agent.run(evalPrompt, runOptions);
+            if (!evalResult.success) {
+                trace.push("评估失败，返回第一个候选方案");
+                return {
+                    success: true,
+                    content: candidates[0].full,
+                    strategy: this.type,
+                    trace,
+                };
+            }
+            trace.push(`评估结果: ${evalResult.content.substring(0, 300)}`);
+            // 解析获胜方案编号
+            const winnerMatch = evalResult.content.match(/最佳方案[：:]\s*候选\s*(\d+)/i);
+            const winnerIdx = winnerMatch
+                ? Math.max(0, Math.min(parseInt(winnerMatch[1]) - 1, candidates.length - 1))
+                : 0;
+            // 提取改进建议
+            const improveMatch = evalResult.content.match(/改进建议[：:]\s*([\s\S]*?)(?:\n\n|$)/i);
+            const improveSuggestion = improveMatch ? improveMatch[1].trim() : "";
+            trace.push(`选择候选 ${winnerIdx + 1}，改进建议: ${improveSuggestion.substring(0, 200)}`);
+            // Phase 3: 基于改进建议，展开最佳方案
+            trace.push("[ToT Phase 3] 展开最佳方案");
+            const refinePrompt = improveSuggestion
+                ? `请基于以下最佳方案和改进建议，输出最终的完整方案。\n\n` +
+                    `最佳方案:\n${candidates[winnerIdx].full}\n\n` +
+                    `改进建议:\n${improveSuggestion}\n\n` +
+                    `要求: 整合改进建议，输出完整、可执行的最终方案。`
+                : `请将以下最佳方案展开为完整的最终输出:\n\n${candidates[winnerIdx].full}\n\n` +
+                    `要求: 详细阐述，形成可执行的完整方案。`;
+            const finalResult = await agent.run(refinePrompt, runOptions);
+            if (!finalResult.success) {
+                return {
+                    success: true,
+                    content: candidates[winnerIdx].full,
+                    strategy: this.type,
+                    trace,
+                };
+            }
+            return {
+                ...finalResult,
+                strategy: this.type,
+                trace,
+            };
+        }
+        finally {
+            if (!config.useAgent) {
+                this.host.agentModule.destroyAgent(agent.id);
+            }
+        }
+    }
+    /** 解析候选方案文本 */
+    _parseCandidates(text) {
+        const candidates = [];
+        // 按【方案 N】分割
+        const parts = text.split(/【方案\s*(\d+)】/);
+        // parts: ["", "1", "方案内容...", "2", "方案内容...", ...]
+        for (let i = 1; i < parts.length; i += 2) {
+            const full = parts[i + 1]?.trim();
+            if (!full || full.length < 10)
+                continue;
+            // 提取"思路:"作为摘要
+            const thoughtMatch = full.match(/思路[：:]\s*(.+)/);
+            const summary = thoughtMatch
+                ? thoughtMatch[1].substring(0, 80)
+                : full.substring(0, 80);
+            candidates.push({ summary, full });
+        }
+        return candidates;
+    }
+}
+exports.TreeReason = TreeReason;
+//# sourceMappingURL=TreeReason.js.map

package/module/ReasonModule/TreeReason.js.map

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

package/module/ReasonModule/index.d.ts

@@ -0,0 +1,8 @@
+export * from "./ReasonModule";
+export * from "./ChainReason";
+export * from "./ReflectReason";
+export * from "./TreeReason";
+export * from "./PlanReason";
+export * from "./CompetitiveReason";
+export * from "./CommanderReason";
+//# sourceMappingURL=index.d.ts.map

package/module/ReasonModule/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/module/ReasonModule/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC"}

package/module/ReasonModule/index.js

@@ -0,0 +1,24 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./ReasonModule"), exports);
+__exportStar(require("./ChainReason"), exports);
+__exportStar(require("./ReflectReason"), exports);
+__exportStar(require("./TreeReason"), exports);
+__exportStar(require("./PlanReason"), exports);
+__exportStar(require("./CompetitiveReason"), exports);
+__exportStar(require("./CommanderReason"), exports);
+//# sourceMappingURL=index.js.map

package/module/ReasonModule/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/module/ReasonModule/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA+B;AAC/B,gDAA8B;AAC9B,kDAAgC;AAChC,+CAA6B;AAC7B,+CAA6B;AAC7B,sDAAoC;AACpC,oDAAkC"}

package/module/SkillModule/SkillModule.d.ts

@@ -0,0 +1,42 @@
+import { AbstractModule, ToolDefinition, Skill } from "../../base";
+/** 技能管理模块 — 能力包注册 + 对话级启用/禁用 */
+export declare class SkillModule extends AbstractModule {
+    /** 技能注册表 */
+    private readonly _skills;
+    /** 对话启用的技能(对话ID → 技能名集合) */
+    private readonly _dialogSkills;
+    constructor();
+    /** 已注册技能数量 */
+    get count(): number;
+    /** 注册技能 */
+    register(skill: Skill): this;
+    /** 批量注册 */
+    registerAll(skills: Array<Skill>): this;
+    /** 移除技能 */
+    unregister(name: string): boolean;
+    /** 获取技能定义 */
+    get(name: string): Skill | undefined;
+    /** 获取全部技能 */
+    list(): Array<Skill>;
+    /** 按分类获取 */
+    listByCategory(category: string): Array<Skill>;
+    /** 为对话启用技能 */
+    enable(dialogId: string, skillName: string): boolean;
+    /** 为对话禁用技能 */
+    disable(dialogId: string, skillName: string): void;
+    /** 获取对话启用的技能名列表 */
+    getEnabled(dialogId: string): Array<string>;
+    /**
+     * 解析对话可用的工具集合
+     *   遍历启用的技能，匹配工具名(支持 "ns/*" 通配),
+     *   从 ToolModule 中查找对应 ToolDefinition
+     */
+    resolveTools(dialogId: string): Array<ToolDefinition>;
+    /**
+     * 聚合对话启用技能的系统提示
+     */
+    buildPrompt(dialogId: string): string;
+    /** 清理对话的技能绑定 */
+    clearDialog(dialogId: string): void;
+}
+//# sourceMappingURL=SkillModule.d.ts.map

package/module/SkillModule/SkillModule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SkillModule.d.ts","sourceRoot":"","sources":["../../../src/module/SkillModule/SkillModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnE,gCAAgC;AAChC,qBAAa,WAAY,SAAQ,cAAc;IAE3C,YAAY;IACZ,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,4BAA4B;IAC5B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA2B;;IASzD,cAAc;IACd,IAAW,KAAK,IAAI,MAAM,CAA8B;IAIxD,WAAW;IACJ,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAMnC,WAAW;IACJ,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,IAAI;IAM9C,WAAW;IACJ,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IASxC,aAAa;IACN,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS;IAK3C,aAAa;IACN,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC;IAK3B,YAAY;IACL,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC;IAOrD,cAAc;IACP,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO;IAa3D,cAAc;IACP,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAKzD,mBAAmB;IACZ,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAMlD;;;;OAIG;IACI,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,KAAK,CAAC,cAAc,CAAC;IA8C5D;;OAEG;IACI,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAe5C,gBAAgB;IACT,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;CAI7C"}

package/module/SkillModule/SkillModule.js

@@ -0,0 +1,134 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SkillModule = void 0;
+const base_1 = require("../../base");
+/** 技能管理模块 — 能力包注册 + 对话级启用/禁用 */
+class SkillModule extends base_1.AbstractModule {
+    constructor() {
+        super();
+        this._skills = new Map();
+        this._dialogSkills = new Map();
+    }
+    /** 已注册技能数量 */
+    get count() { return this._skills.size; }
+    // ======================== 技能注册 ========================
+    /** 注册技能 */
+    register(skill) {
+        this._skills.set(skill.name, skill);
+        return this;
+    }
+    /** 批量注册 */
+    registerAll(skills) {
+        for (const s of skills) {
+            this.register(s);
+        }
+        return this;
+    }
+    /** 移除技能 */
+    unregister(name) {
+        for (const [, skills] of this._dialogSkills) {
+            skills.delete(name);
+        }
+        return this._skills.delete(name);
+    }
+    /** 获取技能定义 */
+    get(name) {
+        return this._skills.get(name);
+    }
+    /** 获取全部技能 */
+    list() {
+        return Array.from(this._skills.values());
+    }
+    /** 按分类获取 */
+    listByCategory(category) {
+        return this.list().filter(s => s.category === category);
+    }
+    // ======================== 对话级启用/禁用 ========================
+    /** 为对话启用技能 */
+    enable(dialogId, skillName) {
+        if (!this._skills.has(skillName)) {
+            return false;
+        }
+        let skills = this._dialogSkills.get(dialogId);
+        if (!skills) {
+            skills = new Set();
+            this._dialogSkills.set(dialogId, skills);
+        }
+        skills.add(skillName);
+        return true;
+    }
+    /** 为对话禁用技能 */
+    disable(dialogId, skillName) {
+        this._dialogSkills.get(dialogId)?.delete(skillName);
+    }
+    /** 获取对话启用的技能名列表 */
+    getEnabled(dialogId) {
+        const skills = this._dialogSkills.get(dialogId);
+        return skills ? Array.from(skills) : [];
+    }
+    /**
+     * 解析对话可用的工具集合
+     *   遍历启用的技能，匹配工具名(支持 "ns/*" 通配),
+     *   从 ToolModule 中查找对应 ToolDefinition
+     */
+    resolveTools(dialogId) {
+        const enabled = this.getEnabled(dialogId);
+        if (enabled.length === 0) {
+            return [];
+        }
+        const toolNames = new Set();
+        const allTools = this.host.toolModule.list();
+        const toolMap = new Map();
+        for (const t of allTools) {
+            toolMap.set(t.name, t);
+        }
+        for (const skillName of enabled) {
+            const skill = this._skills.get(skillName);
+            if (!skill) {
+                continue;
+            }
+            for (const pattern of skill.tools) {
+                if (pattern.endsWith("/*")) {
+                    // 通配: "pc/*" → 匹配 "pc/screenshot", "pc/clipboard", ...
+                    const prefix = pattern.slice(0, -1);
+                    for (const name of toolMap.keys()) {
+                        if (name.startsWith(prefix)) {
+                            toolNames.add(name);
+                        }
+                    }
+                }
+                else {
+                    // 精确匹配
+                    if (toolMap.has(pattern)) {
+                        toolNames.add(pattern);
+                    }
+                }
+            }
+        }
+        return Array.from(toolNames).map(n => toolMap.get(n)).filter(Boolean);
+    }
+    /**
+     * 聚合对话启用技能的系统提示
+     */
+    buildPrompt(dialogId) {
+        const enabled = this.getEnabled(dialogId);
+        if (enabled.length === 0) {
+            return "";
+        }
+        const parts = [];
+        for (const skillName of enabled) {
+            const skill = this._skills.get(skillName);
+            if (!skill?.systemPrompt) {
+                continue;
+            }
+            parts.push(`[${skillName}]: ${skill.systemPrompt}`);
+        }
+        return parts.join("\n");
+    }
+    /** 清理对话的技能绑定 */
+    clearDialog(dialogId) {
+        this._dialogSkills.delete(dialogId);
+    }
+}
+exports.SkillModule = SkillModule;
+//# sourceMappingURL=SkillModule.js.map

package/module/SkillModule/SkillModule.js.map

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

package/module/SkillModule/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./SkillModule";
+//# sourceMappingURL=index.d.ts.map

package/module/SkillModule/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/module/SkillModule/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC"}

package/module/SkillModule/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./SkillModule"), exports);
+//# sourceMappingURL=index.js.map

package/module/SkillModule/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/module/SkillModule/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gDAA8B"}

package/module/ToolModule/ToolModule.d.ts

@@ -0,0 +1,57 @@
+import { AbstractModule, ToolDefinition, ToolContext } from "../../base";
+import { OpenAIUtility } from "../../utility";
+import { IEmbeddingProvider } from "./ToolRAG";
+/** 工具管理模块 — 注册表 + 缓存 + 重试 + 执行调度 */
+export declare class ToolModule extends AbstractModule {
+    /** 工具注册表 */
+    private readonly _tools;
+    /** 结果缓存 */
+    private readonly _cache;
+    /** 工具语义检索器(可选) */
+    private readonly _rag;
+    constructor();
+    /** 已注册工具数量 */
+    get count(): number;
+    /** 注册单个工具 */
+    register(tool: ToolDefinition): this;
+    /** 批量注册 */
+    registerAll(tools: Array<ToolDefinition>): this;
+    /** 移除工具 */
+    unregister(name: string): boolean;
+    /** 获取工具定义 */
+    get(name: string): ToolDefinition | undefined;
+    /** 获取全部工具 */
+    list(): Array<ToolDefinition>;
+    /** 按分类获取 */
+    listByCategory(category: string): Array<ToolDefinition>;
+    /** 设置语义检索的嵌入提供者(不设则使用内置关键词匹配) */
+    setEmbeddingProvider(provider: IEmbeddingProvider): void;
+    /**
+     * 根据用户输入从候选工具中检索最相关的 Top-K 个
+     *   先经过 RAG 语义排序，再取前 topK 个
+     * @param query      用户输入
+     * @param candidates 候选工具名列表(如 Skill 过滤后的结果)
+     * @param topK       返回数量
+     */
+    selectTools(query: string, candidates?: Array<string>, topK?: number): Promise<Array<string>>;
+    /**
+     * 导出为 OpenAI API 工具列表(可按名称过滤)
+     * @param names     工具名白名单
+     * @param compact   精简模式：去掉 schema 中的 description/default，减少 token 开销
+     */
+    ToAPITools(names?: Array<string>, compact?: boolean): Array<OpenAIUtility.OpenAI.ToolCall>;
+    /** 递归裁剪 JSONSchema：去掉 description/default，只保留 type/enum/required/properties/items */
+    private stripSchema;
+    private cacheKey;
+    private checkCache;
+    private setCache;
+    /** 清除缓存(可按工具名精确清除) */
+    invalidateCache(name?: string): void;
+    /** 执行单个工具调用 */
+    Execute(toolCall: OpenAIUtility.OpenAI.ToolResponse, ctx: ToolContext): Promise<string>;
+    /** 批量执行(自动分组并行/串行) */
+    ExecuteBatch(toolCalls: Array<OpenAIUtility.OpenAI.ToolResponse>, ctx: ToolContext): Promise<Map<string, string>>;
+    /** 清空全部工具和缓存 */
+    clear(): void;
+}
+//# sourceMappingURL=ToolModule.d.ts.map

package/module/ToolModule/ToolModule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolModule.d.ts","sourceRoot":"","sources":["../../../src/module/ToolModule/ToolModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAW,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAExD,oCAAoC;AACpC,qBAAa,UAAW,SAAQ,cAAc;IAE1C,YAAY;IACZ,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA8B;IACrD,WAAW;IACX,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0B;IACjD,kBAAkB;IAClB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA0B;;IAS/C,cAAc;IACd,IAAW,KAAK,IAAI,MAAM,CAA6B;IAIvD,aAAa;IACN,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI;IAO3C,WAAW;IACJ,WAAW,CAAC,KAAK,EAAE,KAAK,CAAC,cAAc,CAAC,GAAG,IAAI;IAMtD,WAAW;IACJ,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAOxC,aAAa;IACN,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAKpD,aAAa;IACN,IAAI,IAAI,KAAK,CAAC,cAAc,CAAC;IAKpC,YAAY;IACL,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,KAAK,CAAC,cAAc,CAAC;IAK9D,iCAAiC;IAC1B,oBAAoB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI;IAK/D;;;;;;OAMG;IACU,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,IAAI,GAAE,MAAW,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAY9G;;;;OAIG;IACI,UAAU,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,GAAE,OAAe,GAAG,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC;IAgBxG,qFAAqF;IACrF,OAAO,CAAC,WAAW;IAqBnB,OAAO,CAAC,QAAQ;IAKhB,OAAO,CAAC,UAAU;IAYlB,OAAO,CAAC,QAAQ;IAMhB,sBAAsB;IACf,eAAe,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAiB3C,eAAe;IACF,OAAO,CAAC,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,YAAY,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IA+CpG,sBAAsB;IACT,YAAY,CAAC,SAAS,EAAE,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAiC9H,gBAAgB;IACT,KAAK,IAAI,IAAI;CAMvB"}