sentinel-agentos 0.3.8 → 0.3.10

package/dist/adapters/evaluation-bridge.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Evaluation Bridge — Evaluator 三阶段评估接入 OpenClaw
+ *
+ * 职责：在每个 tool call 的 preCheck/postCheck 中自动采集指标，
+ *      累积到 Profiler，定期生成质量报告注入 daily log。
+ *
+ * 数据流：
+ *   Guard preCheck → PreExecEvaluator → 参数质量+上下文利用评分
+ *   tool 执行     → RuntimeEvaluator → 重试/超时/自纠正评分
+ *   Guard postCheck → PostExecEvaluator → 验证通过/用户接受评分
+ *   ↓
+ *   AgentProfiler → 综合评分(0-100) + 趋势 + 警告/亮点
+ *   ↓
+ *   ImplicitFeedback → 从 audit log 推断用户满意度
+ */
+import { WorkingMemory } from '../memory/working';
+import { AgentProfile } from '../evaluator/profiler';
+export declare class EvaluationBridge {
+    private schemaGate;
+    private riskGate;
+    private working;
+    private preEvaluator;
+    private runtimeEvaluator;
+    private postEvaluator;
+    private feedback;
+    private profiler;
+    private sessionId;
+    private pending;
+    constructor(working: WorkingMemory, sessionId?: string);
+    /** tool 执行前：采集 PreExec 指标，返回操作 ID */
+    preExec(toolName: string, params: Record<string, unknown>): string;
+    /** tool 执行后：采集 Runtime + PostExec 指标，计入 Profiler */
+    postExec(opId: string, options?: {
+        hadTimeout?: boolean;
+        retryCount?: number;
+        wasSelfCorrected?: boolean;
+        verifyPassed?: boolean;
+        verifyChecks?: number;
+        verifyFailures?: number;
+        result?: unknown;
+    }): void;
+    /** 记录隐式反馈信号 */
+    recordFeedback(signal: string, confidence?: number): void;
+    /** 获取综合质量画像 */
+    getProfile(): AgentProfile;
+    /** 获取满意度分数 */
+    getSatisfaction(): number;
+    /** 获取反馈统计 */
+    getFeedbackStats(): {
+        totalSignals: number;
+        positiveSignals: number;
+        negativeSignals: number;
+        averageStrength: number;
+        mostCommonSignal: import("..").SignalType | null;
+    };
+    /** 获取工具准确率 */
+    getToolAccuracy(): Record<string, {
+        calls: number;
+        successRate: number;
+    }>;
+    /** 获取结果利用率 */
+    getUtilizationRate(): number;
+    /** 获取本次会话的操作数 */
+    getOperationCount(): number;
+    /** 生成人类可读的评估报告 */
+    generateReport(): string;
+    /** 生成精简版报告（注入 daily log） */
+    generateCompactReport(): string;
+    /** 追加报告到 daily log */
+    appendToDailyLog(workspaceRoot: string): void;
+    /** 导出可序列化的状态 */
+    exportState(): object;
+    /** 导入之前的状态（用于恢复） */
+    importState(state: any): void;
+}
+export declare function getEvaluationBridge(working?: WorkingMemory, sessionId?: string): EvaluationBridge;
+export declare function resetEvaluationBridge(): void;
+//# sourceMappingURL=evaluation-bridge.d.ts.map

package/dist/adapters/evaluation-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluation-bridge.d.ts","sourceRoot":"","sources":["../../src/adapters/evaluation-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAIlD,OAAO,EAAiB,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAKpE,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,YAAY,CAAmB;IACvC,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,aAAa,CAAoB;IACzC,OAAO,CAAC,QAAQ,CAAyB;IACzC,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,SAAS,CAAS;IAG1B,OAAO,CAAC,OAAO,CAAmF;gBAEtF,OAAO,EAAE,aAAa,EAAE,SAAS,CAAC,EAAE,MAAM;IActD,qCAAqC;IACrC,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;IAalE,oDAAoD;IACpD,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE;QAC9B,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAC3B,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,MAAM,CAAC,EAAE,OAAO,CAAC;KACb,GAAG,IAAI;IAwCb,eAAe;IACf,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI;IAkBzD,eAAe;IACf,UAAU,IAAI,YAAY;IAI1B,cAAc;IACd,eAAe,IAAI,MAAM;IAIzB,aAAa;IACb,gBAAgB;;;;;;;IAIhB,cAAc;IACd,eAAe;;;;IAIf,cAAc;IACd,kBAAkB,IAAI,MAAM;IAI5B,iBAAiB;IACjB,iBAAiB,IAAI,MAAM;IAM3B,kBAAkB;IAClB,cAAc,IAAI,MAAM;IA0CxB,4BAA4B;IAC5B,qBAAqB,IAAI,MAAM;IAc/B,sBAAsB;IACtB,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI;IAiB7C,gBAAgB;IAChB,WAAW,IAAI,MAAM;IAWrB,oBAAoB;IACpB,WAAW,CAAC,KAAK,EAAE,GAAG,GAAG,IAAI;CAI9B;AAKD,wBAAgB,mBAAmB,CAAC,OAAO,CAAC,EAAE,aAAa,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAMjG;AAED,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C"}

package/dist/adapters/evaluation-bridge.js

@@ -0,0 +1,273 @@
+"use strict";
+/**
+ * Evaluation Bridge — Evaluator 三阶段评估接入 OpenClaw
+ *
+ * 职责：在每个 tool call 的 preCheck/postCheck 中自动采集指标，
+ *      累积到 Profiler，定期生成质量报告注入 daily log。
+ *
+ * 数据流：
+ *   Guard preCheck → PreExecEvaluator → 参数质量+上下文利用评分
+ *   tool 执行     → RuntimeEvaluator → 重试/超时/自纠正评分
+ *   Guard postCheck → PostExecEvaluator → 验证通过/用户接受评分
+ *   ↓
+ *   AgentProfiler → 综合评分(0-100) + 趋势 + 警告/亮点
+ *   ↓
+ *   ImplicitFeedback → 从 audit log 推断用户满意度
+ */
+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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EvaluationBridge = void 0;
+exports.getEvaluationBridge = getEvaluationBridge;
+exports.resetEvaluationBridge = resetEvaluationBridge;
+const schema_gate_1 = require("../guard/schema-gate");
+const risk_gate_1 = require("../guard/risk-gate");
+const exec_evaluator_1 = require("../evaluator/exec-evaluator");
+const exec_evaluator_2 = require("../evaluator/exec-evaluator");
+const exec_evaluator_3 = require("../evaluator/exec-evaluator");
+const profiler_1 = require("../evaluator/profiler");
+const feedback_1 = require("../evaluator/feedback");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+class EvaluationBridge {
+    schemaGate;
+    riskGate;
+    working;
+    preEvaluator;
+    runtimeEvaluator;
+    postEvaluator;
+    feedback;
+    profiler;
+    sessionId;
+    // 待完成的评估周期（pre 已记录，等待 post）
+    pending = new Map();
+    constructor(working, sessionId) {
+        this.schemaGate = new schema_gate_1.SchemaGate();
+        this.riskGate = new risk_gate_1.RiskGate();
+        this.working = working;
+        this.preEvaluator = new exec_evaluator_1.PreExecEvaluator(this.schemaGate, this.riskGate, this.working);
+        this.runtimeEvaluator = new exec_evaluator_2.RuntimeEvaluator();
+        this.postEvaluator = new exec_evaluator_3.PostExecEvaluator();
+        this.feedback = new feedback_1.ImplicitFeedbackEngine();
+        this.profiler = new profiler_1.AgentProfiler(this.feedback);
+        this.sessionId = sessionId || `eval_${Date.now()}`;
+    }
+    // ============== 生命周期 ==============
+    /** tool 执行前：采集 PreExec 指标，返回操作 ID */
+    preExec(toolName, params) {
+        const opId = `op_${Date.now()}_${Math.random().toString(36).slice(2, 6)}`;
+        const preMetric = this.preEvaluator.evaluate(toolName, params);
+        this.pending.set(opId, {
+            preMetric,
+            startTime: Date.now(),
+            toolName,
+        });
+        return opId;
+    }
+    /** tool 执行后：采集 Runtime + PostExec 指标，计入 Profiler */
+    postExec(opId, options = {}) {
+        const entry = this.pending.get(opId);
+        if (!entry)
+            return;
+        const endTime = Date.now();
+        const { preMetric, startTime, toolName } = entry;
+        this.pending.delete(opId);
+        // Runtime 评估
+        const runtime = this.runtimeEvaluator.evaluate({
+            toolName,
+            startTime,
+            endTime,
+            retryCount: options.retryCount ?? 0,
+            wasSelfCorrected: options.wasSelfCorrected ?? false,
+            hadTimeout: options.hadTimeout ?? false,
+            toolResult: options.result,
+        });
+        // Post 评估
+        const post = this.postEvaluator.evaluate({
+            verifyPassed: options.verifyPassed ?? true,
+            verifyChecks: options.verifyChecks ?? 1,
+            verifyFailures: options.verifyFailures ?? 0,
+            userAccepted: true, // 默认 true，feedback 会修正
+            userProvidedEdit: false,
+            resultWasUsed: false,
+        });
+        // 追踪结果（后续 detected usage）
+        if (options.result !== undefined) {
+            this.postEvaluator.trackResult(opId, options.result);
+        }
+        // 入 Profiler
+        this.profiler.recordCycle(this.sessionId, preMetric, runtime, post);
+    }
+    // ============== Feedback ==============
+    /** 记录隐式反馈信号 */
+    recordFeedback(signal, confidence) {
+        const validSignals = [
+            'user_deleted_code', 'user_modified_output', 'user_repeated_instruction',
+            'user_immediate_continue', 'user_used_result', 'user_silence_then_praise',
+            'user_interrupted', 'agent_self_corrected', 'user_explicit_approval',
+            'user_shared_output', 'user_provided_correction', 'user_ignored_result',
+        ];
+        if (!validSignals.includes(signal)) {
+            console.warn(`[Evaluator] Unknown signal: ${signal}`);
+            return;
+        }
+        this.feedback.record(signal, this.sessionId, undefined, confidence ?? 0.8);
+    }
+    // ============== 查询 ==============
+    /** 获取综合质量画像 */
+    getProfile() {
+        return this.profiler.getProfile(this.sessionId);
+    }
+    /** 获取满意度分数 */
+    getSatisfaction() {
+        return this.feedback.getSatisfactionScore(this.sessionId);
+    }
+    /** 获取反馈统计 */
+    getFeedbackStats() {
+        return this.feedback.stats();
+    }
+    /** 获取工具准确率 */
+    getToolAccuracy() {
+        return this.runtimeEvaluator.getToolAccuracy();
+    }
+    /** 获取结果利用率 */
+    getUtilizationRate() {
+        return this.postEvaluator.getUtilizationRate();
+    }
+    /** 获取本次会话的操作数 */
+    getOperationCount() {
+        return this.pending.size + (this.getProfile().totalOps || 0);
+    }
+    // ============== 报告生成 ==============
+    /** 生成人类可读的评估报告 */
+    generateReport() {
+        const profile = this.getProfile();
+        const feedbackStats = this.getFeedbackStats();
+        const toolAcc = this.getToolAccuracy();
+        const satisfaction = this.getSatisfaction();
+        const lines = [
+            '═══ 📊 AgentOS Evaluator 报告 ═══',
+            '',
+            `🎯 综合评分: ${profile.overallScore}/100`,
+            '',
+            '📈 分项评分:',
+            `  ├─ 参数质量:   ${profile.breakdown.preExec}/100`,
+            `  ├─ 执行质量:   ${profile.breakdown.runtime}/100`,
+            `  ├─ 结果验证:   ${profile.breakdown.postExec}/100`,
+            `  └─ 用户满意度: ${profile.breakdown.userSatisfaction}/100`,
+            '',
+            `📊 趋势: ${profile.trends.improving ? '📈 上升' : '📉 下降'} (最近${profile.trends.recentOps}次: ${Math.round(profile.trends.recentScore)}/100)`,
+            '',
+        ];
+        if (profile.strengths.length > 0) {
+            lines.push('✅ 亮点:');
+            for (const s of profile.strengths)
+                lines.push(`  · ${s}`);
+            lines.push('');
+        }
+        if (profile.warnings.length > 0) {
+            lines.push('⚠️ 需改进:');
+            for (const w of profile.warnings)
+                lines.push(`  · ${w}`);
+            lines.push('');
+        }
+        lines.push(`💬 反馈: ${feedbackStats.totalSignals} 信号 (${feedbackStats.positiveSignals}正 / ${feedbackStats.negativeSignals}负)`);
+        lines.push(`🛠 工具准确率: ${Object.entries(toolAcc).map(([t, v]) => `${t}:${v.successRate}`).join(', ')}`);
+        lines.push(`📐 满意度: ${satisfaction}`);
+        lines.push('');
+        lines.push('══════════════════════════════');
+        return lines.join('\n');
+    }
+    /** 生成精简版报告（注入 daily log） */
+    generateCompactReport() {
+        const profile = this.getProfile();
+        return [
+            `## 📊 AgentOS Evaluator 今日评估`,
+            '',
+            `**综合评分**: ${profile.overallScore}/100 | Pre:${profile.breakdown.preExec}/100 | Run:${profile.breakdown.runtime}/100 | Post:${profile.breakdown.postExec}/100`,
+            `**趋势**: ${profile.trends.improving ? '📈 上升' : '📉 下降'} | **操作数**: ${profile.totalOps}`,
+            profile.warnings.length > 0 ? `**⚠️**: ${profile.warnings.join('; ')}` : '',
+            profile.strengths.length > 0 ? `**✅**: ${profile.strengths.join('; ')}` : '',
+            '',
+        ].filter(Boolean).join('\n');
+    }
+    /** 追加报告到 daily log */
+    appendToDailyLog(workspaceRoot) {
+        const dateKey = new Date().toISOString().split('T')[0];
+        const dailyFile = path.join(workspaceRoot, 'memory', `${dateKey}.md`);
+        const report = this.generateCompactReport();
+        try {
+            const existing = fs.existsSync(dailyFile) ? fs.readFileSync(dailyFile, 'utf-8') : '';
+            if (!existing.includes('AgentOS Evaluator')) {
+                fs.appendFileSync(dailyFile, `\n${report}\n`, 'utf-8');
+            }
+        }
+        catch (e) {
+            console.warn('[Evaluator] Failed to append report:', e);
+        }
+    }
+    // ============== 持久化 ==============
+    /** 导出可序列化的状态 */
+    exportState() {
+        return {
+            sessionId: this.sessionId,
+            profile: this.getProfile(),
+            feedback: this.getFeedbackStats(),
+            toolAccuracy: this.getToolAccuracy(),
+            utilizationRate: this.getUtilizationRate(),
+            exportedAt: new Date().toISOString(),
+        };
+    }
+    /** 导入之前的状态（用于恢复） */
+    importState(state) {
+        if (state.sessionId)
+            this.sessionId = state.sessionId;
+        // Profiler/Feedback 不支持完整恢复，只恢复 sessionId
+    }
+}
+exports.EvaluationBridge = EvaluationBridge;
+// ============== Singleton ==============
+let _evalBridge = null;
+function getEvaluationBridge(working, sessionId) {
+    if (!_evalBridge) {
+        if (!working)
+            throw new Error('First call requires WorkingMemory instance');
+        _evalBridge = new EvaluationBridge(working, sessionId);
+    }
+    return _evalBridge;
+}
+function resetEvaluationBridge() {
+    _evalBridge = null;
+}
+//# sourceMappingURL=evaluation-bridge.js.map

package/dist/adapters/evaluation-bridge.js.map

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

package/dist/adapters/memory-bridge.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Memory Bridge — 将 AgentOS Memory 三层接入 OpenClaw 工作流
+ *
+ * ┌─────────────┐     ┌──────────────┐     ┌──────────────┐
+ * │  MEMORY.md   │ →   │  Semantic    │ ←   │ 会话中学习   │
+ * │  旧文件系统   │     │  Memory      │     │ 新规则/偏好   │
+ * └─────────────┘     └──────┬───────┘     └──────────────┘
+ *                            │
+ *     ┌──────────────────────┼──────────────────────┐
+ *     │                      │                      │
+ *     ▼                      ▼                      ▼
+ *  Session启动          Session运行             Session结束
+ *  注入上下文            工具结果缓存            事件→Episodic
+ *                      消息→Working             偏好→Semantic
+ *
+ * 用法:
+ *   1. Session 启动: MemoryBridge.onSessionStart(workspaceRoot)
+ *      → 返回要注入的上下文字符串
+ *   2. Session 中:   MemoryBridge.getWorkingMemory()
+ *      → 获取 Working Memory 实例
+ *   3. Session 结束: MemoryBridge.onSessionEnd()
+ *      → 清空 Working、同步 Episodic
+ */
+import { WorkingMemory } from '../memory/working';
+import { EpisodicMemory } from '../memory/episodic';
+import { SemanticMemoryStore } from '../memory/semantic';
+import { EventType } from '../types';
+export interface MemorySnapshot {
+    semantic: Record<string, unknown>;
+    episodic: Record<string, unknown>;
+    working: Record<string, unknown>;
+}
+export declare class MemoryBridge {
+    private working;
+    private episodic;
+    private semantic;
+    private started;
+    private startTime;
+    constructor(workspaceRoot: string);
+    /**
+     * Session 启动时调用
+     * 返回要注入到系统提示的上下文摘要
+     */
+    onSessionStart(): string;
+    /**
+     * Session 运行中：记录一条消息到 Working Memory
+     */
+    recordMessage(role: 'user' | 'agent' | 'tool', content: string): void;
+    /**
+     * Session 运行中：缓存工具调用结果
+     */
+    cacheToolResult(toolName: string, result: unknown): void;
+    /**
+     * Session 结束：清空 Working + 同步到 Episodic
+     *
+     * @param autoRecord 是否自动从 Working 提取事件到 Episodic
+     */
+    onSessionEnd(autoRecord?: boolean): void;
+    /**
+     * 记录自定义事件到 Episodic Memory
+     */
+    recordEvent(type: EventType, content: string, tags?: string[], relatedEntities?: string[], importanceBoost?: number): void;
+    /** 学习新规则 */
+    learnRule(rule: string, source: string): void;
+    /** 设置用户偏好 */
+    setPreference(key: string, value: unknown): void;
+    /** 添加用户事实 */
+    addFact(fact: string): void;
+    /** 更新项目上下文 */
+    setProjectContext(name: string, ctx: {
+        description?: string;
+        techStack?: string[];
+        conventions?: string[];
+        architecture?: string;
+        knownIssues?: string[];
+    }): void;
+    /** 获取项目上下文 */
+    getProjectContext(name: string): Record<string, unknown> | undefined;
+    /** 获取完整记忆状态快照 */
+    getSnapshot(): MemorySnapshot;
+    /** 获取 Working Memory 实例（供中间件使用） */
+    getWorkingMemory(): WorkingMemory;
+    /** 获取 Semantic Memory 实例 */
+    getSemanticMemory(): SemanticMemoryStore;
+    /** 获取 Episodic Memory 实例 */
+    getEpisodicMemory(): EpisodicMemory;
+    /** 获取 session 持续时间（ms） */
+    getElapsedMs(): number;
+    /**
+     * 从 Working Memory 自动提取关键事件到 Episodic
+     */
+    private autoRecordFromWorking;
+    /** 刷新所有持久化（确保写入磁盘） */
+    flush(): void;
+    /** 生成状态报告 */
+    statusReport(): string;
+    /**
+     * 从现有的 MEMORY.md 文件迁移数据到 Semantic Memory
+     * 只运行一次，迁移后旧文件可以保留或删除
+     */
+    migrateFromMemoryMd(memoryPath: string): {
+        imported: number;
+        skipped: number;
+    };
+}
+/** 获取全局 MemoryBridge 实例 */
+export declare function getMemoryBridge(workspaceRoot?: string): MemoryBridge;
+/** 重置全局实例（用于测试） */
+export declare function resetMemoryBridge(): void;
+//# sourceMappingURL=memory-bridge.d.ts.map

package/dist/adapters/memory-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-bridge.d.ts","sourceRoot":"","sources":["../../src/adapters/memory-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAGrC,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,QAAQ,CAAsB;IACtC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,SAAS,CAAS;gBAEd,aAAa,EAAE,MAAM;IAWjC;;;OAGG;IACH,cAAc,IAAI,MAAM;IAqBxB;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAIrE;;OAEG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI;IAIxD;;;;OAIG;IACH,YAAY,CAAC,UAAU,UAAO,GAAG,IAAI;IAYrC;;OAEG;IACH,WAAW,CACT,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,MAAM,EAAO,EACnB,eAAe,GAAE,MAAM,EAAO,EAC9B,eAAe,SAAI,GAClB,IAAI;IAMP,YAAY;IACZ,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAI7C,aAAa;IACb,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAIhD,aAAa;IACb,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI3B,cAAc;IACd,iBAAiB,CACf,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE;QACH,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;QACvB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;KACxB,GACA,IAAI;IAIP,cAAc;IACd,iBAAiB,CAAC,IAAI,EAAE,MAAM;IAM9B,iBAAiB;IACjB,WAAW,IAAI,cAAc;IAQ7B,mCAAmC;IACnC,gBAAgB,IAAI,aAAa;IAIjC,4BAA4B;IAC5B,iBAAiB,IAAI,mBAAmB;IAIxC,4BAA4B;IAC5B,iBAAiB,IAAI,cAAc;IAInC,0BAA0B;IAC1B,YAAY,IAAI,MAAM;IAMtB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA6B7B,sBAAsB;IACtB,KAAK,IAAI,IAAI;IAIb,aAAa;IACb,YAAY,IAAI,MAAM;IAgBtB;;;OAGG;IACH,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;CAsF/E;AAKD,2BAA2B;AAC3B,wBAAgB,eAAe,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,YAAY,CAQpE;AAED,mBAAmB;AACnB,wBAAgB,iBAAiB,IAAI,IAAI,CAKxC"}