@toyako/hive 1.0.0

package/dist/kernel/ExecutionState.js

@@ -0,0 +1,124 @@
+"use strict";
+/**
+ * ExecutionState — PATCH 2: Execution State Machine (轻量版)
+ *
+ * 让 execution 不再是 "flow"，而是 "state machine"
+ *
+ * 核心功能：
+ * - 显式状态跟踪
+ * - 结构化失败处理
+ * - 可追溯调试
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExecutionContext = exports.ExecutionState = void 0;
+var ExecutionState;
+(function (ExecutionState) {
+    ExecutionState["INIT"] = "INIT";
+    ExecutionState["PLANNED"] = "PLANNED";
+    ExecutionState["EXECUTING"] = "EXECUTING";
+    ExecutionState["REVIEWING"] = "REVIEWING";
+    ExecutionState["FAILED"] = "FAILED";
+    ExecutionState["COMPLETED"] = "COMPLETED";
+    ExecutionState["BLOCKED"] = "BLOCKED";
+})(ExecutionState || (exports.ExecutionState = ExecutionState = {}));
+class ExecutionContext {
+    taskId;
+    state = ExecutionState.INIT;
+    stateHistory = [];
+    constructor(taskId) {
+        this.taskId = taskId;
+        this.recordState(ExecutionState.INIT, "Execution context created");
+    }
+    /**
+     * 转换到下一个状态
+     *
+     * @param next 下一个状态
+     * @param reason 转换原因
+     * @throws Error 如果状态转换无效
+     */
+    transition(next, reason) {
+        // 🚨 BLOCKED 状态是终态，不能转换
+        if (this.state === ExecutionState.BLOCKED) {
+            throw new Error(`Execution is blocked, cannot transition to ${next}`);
+        }
+        // 🚨 FAILED 状态是终态，不能转换
+        if (this.state === ExecutionState.FAILED) {
+            throw new Error(`Execution has failed, cannot transition to ${next}`);
+        }
+        // 🚨 COMPLETED 状态是终态，不能转换
+        if (this.state === ExecutionState.COMPLETED) {
+            throw new Error(`Execution has completed, cannot transition to ${next}`);
+        }
+        // 验证状态转换的合法性
+        if (!this.isValidTransition(this.state, next)) {
+            throw new Error(`Invalid state transition: ${this.state} → ${next}`);
+        }
+        this.state = next;
+        this.recordState(next, reason);
+    }
+    /**
+     * 标记执行失败
+     *
+     * @param reason 失败原因
+     */
+    markFailed(reason) {
+        this.state = ExecutionState.FAILED;
+        this.recordState(ExecutionState.FAILED, reason);
+    }
+    /**
+     * 标记执行被阻断
+     *
+     * @param reason 阻断原因
+     */
+    markBlocked(reason) {
+        this.state = ExecutionState.BLOCKED;
+        this.recordState(ExecutionState.BLOCKED, reason);
+    }
+    /**
+     * 检查是否可以继续执行
+     */
+    canContinue() {
+        return this.state !== ExecutionState.FAILED &&
+            this.state !== ExecutionState.BLOCKED &&
+            this.state !== ExecutionState.COMPLETED;
+    }
+    /**
+     * 获取状态历史
+     */
+    getHistory() {
+        return [...this.stateHistory];
+    }
+    /**
+     * 获取当前状态
+     */
+    getCurrentState() {
+        return this.state;
+    }
+    /**
+     * 获取任务ID
+     */
+    getTaskId() {
+        return this.taskId;
+    }
+    recordState(state, reason) {
+        this.stateHistory.push({
+            state,
+            timestamp: Date.now(),
+            reason
+        });
+    }
+    isValidTransition(from, to) {
+        const validTransitions = {
+            [ExecutionState.INIT]: [ExecutionState.PLANNED, ExecutionState.EXECUTING, ExecutionState.FAILED, ExecutionState.BLOCKED],
+            [ExecutionState.PLANNED]: [ExecutionState.EXECUTING, ExecutionState.FAILED, ExecutionState.BLOCKED],
+            [ExecutionState.EXECUTING]: [ExecutionState.REVIEWING, ExecutionState.COMPLETED, ExecutionState.FAILED, ExecutionState.BLOCKED],
+            [ExecutionState.REVIEWING]: [ExecutionState.COMPLETED, ExecutionState.FAILED, ExecutionState.BLOCKED],
+            [ExecutionState.FAILED]: [], // 终态
+            [ExecutionState.COMPLETED]: [], // 终态
+            [ExecutionState.BLOCKED]: [] // 终态
+        };
+        return validTransitions[from]?.includes(to) ?? false;
+    }
+}
+exports.ExecutionContext = ExecutionContext;
+//# sourceMappingURL=ExecutionState.js.map

package/dist/kernel/ExecutionState.js.map

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

package/dist/kernel/FailureInterceptor.d.ts

@@ -0,0 +1,51 @@
+/**
+ * FailureInterceptor — PATCH 3: Failure Propagation Interceptor
+ *
+ * 所有 failure 必须被 kernel 统一处理，不能"自然流过"
+ *
+ * 核心功能：
+ * - 标准化结果
+ * - 强制执行 kernel 规则
+ * - 阻断 silent failure
+ */
+import { ExecutionContext } from "./ExecutionState";
+export interface NormalizedResult {
+    success: boolean;
+    data?: any;
+    error?: any;
+    taskId: string;
+    timestamp: number;
+}
+export declare class FailureInterceptor {
+    /**
+     * 处理执行结果，强制执行 kernel 规则
+     *
+     * @param result 原始执行结果
+     * @param context 执行上下文（可选）
+     * @returns 标准化结果
+     * @throws KernelPanicError 如果验证失败
+     */
+    static handle(result: any, context?: ExecutionContext): NormalizedResult;
+    /**
+     * 安全处理执行结果，不抛出异常
+     *
+     * @param result 原始执行结果
+     * @param context 执行上下文（可选）
+     * @returns { success: boolean, result?: NormalizedResult, error?: string }
+     */
+    static safeHandle(result: any, context?: ExecutionContext): {
+        success: boolean;
+        result?: NormalizedResult;
+        error?: string;
+    };
+    /**
+     * 包装 executor 执行，添加 kernel enforcement
+     *
+     * @param executor 执行函数
+     * @param task 任务
+     * @param context 执行上下文（可选）
+     * @returns 标准化结果
+     */
+    static wrapExecution(executor: (task: any) => Promise<any>, task: any, context?: ExecutionContext): Promise<NormalizedResult>;
+}
+//# sourceMappingURL=FailureInterceptor.d.ts.map

package/dist/kernel/FailureInterceptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FailureInterceptor.d.ts","sourceRoot":"","sources":["../../src/kernel/FailureInterceptor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,gBAAgB,EAAkB,MAAM,kBAAkB,CAAC;AAEpE,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,kBAAkB;IAE7B;;;;;;;OAOG;IACH,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,gBAAgB;IA4CxE;;;;;;OAMG;IACH,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG;QAC1D,OAAO,EAAE,OAAO,CAAC;QACjB,MAAM,CAAC,EAAE,gBAAgB,CAAC;QAC1B,KAAK,CAAC,EAAE,MAAM,CAAA;KACf;IAgBD;;;;;;;OAOG;WACU,aAAa,CACxB,QAAQ,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,EACrC,IAAI,EAAE,GAAG,EACT,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,gBAAgB,CAAC;CAoB7B"}

package/dist/kernel/FailureInterceptor.js

@@ -0,0 +1,112 @@
+"use strict";
+/**
+ * FailureInterceptor — PATCH 3: Failure Propagation Interceptor
+ *
+ * 所有 failure 必须被 kernel 统一处理，不能"自然流过"
+ *
+ * 核心功能：
+ * - 标准化结果
+ * - 强制执行 kernel 规则
+ * - 阻断 silent failure
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FailureInterceptor = void 0;
+const KernelGate_1 = require("./KernelGate");
+const ExecutionState_1 = require("./ExecutionState");
+class FailureInterceptor {
+    /**
+     * 处理执行结果，强制执行 kernel 规则
+     *
+     * @param result 原始执行结果
+     * @param context 执行上下文（可选）
+     * @returns 标准化结果
+     * @throws KernelPanicError 如果验证失败
+     */
+    static handle(result, context) {
+        // 🚨 标准化结果
+        const normalized = {
+            success: result?.success ?? true,
+            data: result?.data || result?.output,
+            error: result?.error,
+            taskId: result?.taskId || result?.task_id || "unknown",
+            timestamp: Date.now()
+        };
+        // 🚨 检测 silent failure
+        if (normalized.success === true && !normalized.data && !normalized.error) {
+            // 这可能是 silent failure
+            console.warn(`[KernelGate] Potential silent failure detected for task ${normalized.taskId}`);
+        }
+        // 🚨 强制执行 kernel 规则
+        try {
+            KernelGate_1.KernelGate.validateExecution({
+                success: normalized.success,
+                error: normalized.error,
+                taskId: normalized.taskId
+            });
+        }
+        catch (error) {
+            // 如果有 context，标记为 BLOCKED
+            if (context) {
+                context.markBlocked(error instanceof Error ? error.message : "Kernel validation failed");
+            }
+            throw error;
+        }
+        // 🚨 如果有 context，更新状态
+        if (context) {
+            if (normalized.success) {
+                context.transition(ExecutionState_1.ExecutionState.COMPLETED, "Execution completed successfully");
+            }
+            else {
+                context.markFailed(`Execution failed: ${normalized.error || "unknown error"}`);
+            }
+        }
+        return normalized;
+    }
+    /**
+     * 安全处理执行结果，不抛出异常
+     *
+     * @param result 原始执行结果
+     * @param context 执行上下文（可选）
+     * @returns { success: boolean, result?: NormalizedResult, error?: string }
+     */
+    static safeHandle(result, context) {
+        try {
+            const normalized = this.handle(result, context);
+            return { success: true, result: normalized };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : "Unknown error";
+            if (context) {
+                context.markBlocked(errorMessage);
+            }
+            return { success: false, error: errorMessage };
+        }
+    }
+    /**
+     * 包装 executor 执行，添加 kernel enforcement
+     *
+     * @param executor 执行函数
+     * @param task 任务
+     * @param context 执行上下文（可选）
+     * @returns 标准化结果
+     */
+    static async wrapExecution(executor, task, context) {
+        if (context) {
+            context.transition(ExecutionState_1.ExecutionState.EXECUTING, "Starting execution");
+        }
+        try {
+            const result = await executor(task);
+            return this.handle(result, context);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : "Execution failed";
+            if (context) {
+                context.markFailed(errorMessage);
+            }
+            // 重新抛出，让调用者处理
+            throw error;
+        }
+    }
+}
+exports.FailureInterceptor = FailureInterceptor;
+//# sourceMappingURL=FailureInterceptor.js.map

package/dist/kernel/FailureInterceptor.js.map

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

package/dist/kernel/KernelGate.d.ts

@@ -0,0 +1,41 @@
+/**
+ * KernelGate — PATCH 1: Hard Stop Enforcement
+ *
+ * 所有 execution 必须经过 gate，否则禁止继续 pipeline
+ *
+ * 核心规则：
+ * - success=false → MUST STOP PIPELINE
+ * - error → MUST STOP PIPELINE
+ */
+export declare class KernelPanicError extends Error {
+    constructor(message: string);
+}
+export declare class KernelGate {
+    /**
+     * 验证执行结果，如果失败则抛出 KernelPanicError
+     *
+     * @param input 执行结果
+     * @returns true 如果验证通过
+     * @throws KernelPanicError 如果验证失败
+     */
+    static validateExecution(input: {
+        success: boolean;
+        error?: any;
+        taskId: string;
+    }): boolean;
+    /**
+     * 安全执行验证，不抛出异常
+     *
+     * @param input 执行结果
+     * @returns { allowed: boolean, reason?: string }
+     */
+    static checkExecution(input: {
+        success: boolean;
+        error?: any;
+        taskId: string;
+    }): {
+        allowed: boolean;
+        reason?: string;
+    };
+}
+//# sourceMappingURL=KernelGate.d.ts.map

package/dist/kernel/KernelGate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KernelGate.d.ts","sourceRoot":"","sources":["../../src/kernel/KernelGate.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,qBAAa,gBAAiB,SAAQ,KAAK;gBAC7B,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,UAAU;IACrB;;;;;;OAMG;IACH,MAAM,CAAC,iBAAiB,CAAC,KAAK,EAAE;QAC9B,OAAO,EAAE,OAAO,CAAC;QACjB,KAAK,CAAC,EAAE,GAAG,CAAC;QACZ,MAAM,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO;IAmBX;;;;;OAKG;IACH,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE;QAC3B,OAAO,EAAE,OAAO,CAAC;QACjB,KAAK,CAAC,EAAE,GAAG,CAAC;QACZ,MAAM,EAAE,MAAM,CAAC;KAChB,GAAG;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;CAkB1C"}

package/dist/kernel/KernelGate.js

@@ -0,0 +1,62 @@
+"use strict";
+/**
+ * KernelGate — PATCH 1: Hard Stop Enforcement
+ *
+ * 所有 execution 必须经过 gate，否则禁止继续 pipeline
+ *
+ * 核心规则：
+ * - success=false → MUST STOP PIPELINE
+ * - error → MUST STOP PIPELINE
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KernelGate = exports.KernelPanicError = void 0;
+class KernelPanicError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "KernelPanicError";
+    }
+}
+exports.KernelPanicError = KernelPanicError;
+class KernelGate {
+    /**
+     * 验证执行结果，如果失败则抛出 KernelPanicError
+     *
+     * @param input 执行结果
+     * @returns true 如果验证通过
+     * @throws KernelPanicError 如果验证失败
+     */
+    static validateExecution(input) {
+        // 🚨 HARD RULE 1: failure stops everything
+        if (input.success === false) {
+            throw new KernelPanicError(`EXECUTION_BLOCKED: success=false, taskId=${input.taskId}, error=${input.error || "unknown"}`);
+        }
+        // 🚨 HARD RULE 2: error stops everything
+        if (input.error) {
+            throw new KernelPanicError(`EXECUTION_BLOCKED: error detected, taskId=${input.taskId}, error=${input.error}`);
+        }
+        return true;
+    }
+    /**
+     * 安全执行验证，不抛出异常
+     *
+     * @param input 执行结果
+     * @returns { allowed: boolean, reason?: string }
+     */
+    static checkExecution(input) {
+        if (input.success === false) {
+            return {
+                allowed: false,
+                reason: `EXECUTION_BLOCKED: success=false, taskId=${input.taskId}`
+            };
+        }
+        if (input.error) {
+            return {
+                allowed: false,
+                reason: `EXECUTION_BLOCKED: error detected, taskId=${input.taskId}`
+            };
+        }
+        return { allowed: true };
+    }
+}
+exports.KernelGate = KernelGate;
+//# sourceMappingURL=KernelGate.js.map

package/dist/kernel/KernelGate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"KernelGate.js","sourceRoot":"","sources":["../../src/kernel/KernelGate.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAEH,MAAa,gBAAiB,SAAQ,KAAK;IACzC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AALD,4CAKC;AAED,MAAa,UAAU;IACrB;;;;;;OAMG;IACH,MAAM,CAAC,iBAAiB,CAAC,KAIxB;QAEC,2CAA2C;QAC3C,IAAI,KAAK,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;YAC5B,MAAM,IAAI,gBAAgB,CACxB,4CAA4C,KAAK,CAAC,MAAM,WAAW,KAAK,CAAC,KAAK,IAAI,SAAS,EAAE,CAC9F,CAAC;QACJ,CAAC;QAED,yCAAyC;QACzC,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAChB,MAAM,IAAI,gBAAgB,CACxB,6CAA6C,KAAK,CAAC,MAAM,WAAW,KAAK,CAAC,KAAK,EAAE,CAClF,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,cAAc,CAAC,KAIrB;QAEC,IAAI,KAAK,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;YAC5B,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,4CAA4C,KAAK,CAAC,MAAM,EAAE;aACnE,CAAC;QACJ,CAAC;QAED,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAChB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,6CAA6C,KAAK,CAAC,MAAM,EAAE;aACpE,CAAC;QACJ,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC;CACF;AA3DD,gCA2DC"}

package/dist/kernel/MultiAgentExecutionKernel.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Multi-Agent Execution Kernel v4.0
+ *
+ * 从"self-modifying execution runtime" → "multi-agent consensus-driven execution kernel"
+ * 从"agent system" → "workflow engine" → "multi-agent execution kernel (AI-native runtime OS core)"
+ *
+ * Agent类型：
+ * - Planner Agent: 拆解任务，生成DAG nodes
+ * - Executor Agent: 执行node，产出result
+ * - Validator Agent: 校验结果，判断success/failure
+ * - Arbiter Agent: 决定冲突
+ */
+export type AgentType = "planner" | "executor" | "validator" | "arbiter";
+export interface Agent {
+    id: string;
+    type: AgentType;
+    name: string;
+}
+export interface AgentGraph {
+    agent_id: string;
+    nodes: {
+        id: string;
+        depends_on: string[];
+        type: string;
+    }[];
+    score: number;
+}
+export type VoteResult = "PASS" | "FAIL" | "RETRY";
+export interface ValidationVote {
+    agent_id: string;
+    node_id: string;
+    vote: VoteResult;
+    reason: string;
+}
+export interface ArbitrationDecision {
+    type: "graph_selection" | "execution_conflict" | "mutation_control";
+    selected?: string;
+    reason: string;
+}
+export interface KernelCycle {
+    cycle_id: string;
+    task: string;
+    agents_active: {
+        planners: string[];
+        executors: string[];
+        validators: string[];
+        arbiters: string[];
+    };
+    graphs_generated: AgentGraph[];
+    final_graph?: AgentGraph;
+    execution_result?: any;
+    consensus_score: number;
+    state_committed: boolean;
+}
+export declare class MultiAgentExecutionKernel {
+    private agents;
+    private cycles;
+    private consensusThreshold;
+    constructor(options?: {
+        consensusThreshold?: number;
+    });
+    /**
+     * 初始化默认 agents
+     */
+    private initializeDefaultAgents;
+    /**
+     * 注册 agent
+     */
+    registerAgent(agent: Agent): void;
+    /**
+     * 执行 kernel cycle
+     */
+    executeCycle(task: string, graphGenerator: (agent: Agent, task: string) => Promise<AgentGraph>, nodeExecutor: (node: any, input: any) => Promise<any>, validator: (nodeId: string, result: any) => Promise<VoteResult>): Promise<KernelCycle>;
+    /**
+     * 仲裁 graphs
+     */
+    private arbitrateGraphs;
+    /**
+     * 分布式执行
+     */
+    private distributedExecution;
+    /**
+     * 验证投票
+     */
+    private validationVoting;
+    /**
+     * 计算共识分数
+     */
+    private calculateConsensus;
+    /**
+     * 获取 cycle
+     */
+    getCycle(cycleId: string): KernelCycle | undefined;
+    /**
+     * 获取所有 agents
+     */
+    getAgents(): Agent[];
+    /**
+     * 格式化输出
+     */
+    format(cycleId: string): string;
+}
+//# sourceMappingURL=MultiAgentExecutionKernel.d.ts.map

package/dist/kernel/MultiAgentExecutionKernel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MultiAgentExecutionKernel.d.ts","sourceRoot":"","sources":["../../src/kernel/MultiAgentExecutionKernel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,WAAW,GAAG,SAAS,CAAC;AAGzE,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAGD,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,EAAE,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC5D,KAAK,EAAE,MAAM,CAAC;CACf;AAGD,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAEnD,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAGD,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,iBAAiB,GAAG,oBAAoB,GAAG,kBAAkB,CAAC;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAGD,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE;QACb,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,SAAS,EAAE,MAAM,EAAE,CAAC;QACpB,UAAU,EAAE,MAAM,EAAE,CAAC;QACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;IACF,gBAAgB,EAAE,UAAU,EAAE,CAAC;IAC/B,WAAW,CAAC,EAAE,UAAU,CAAC;IACzB,gBAAgB,CAAC,EAAE,GAAG,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,qBAAa,yBAAyB;IACpC,OAAO,CAAC,MAAM,CAAiC;IAC/C,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,kBAAkB,CAAS;gBAEvB,OAAO,CAAC,EAAE;QAAE,kBAAkB,CAAC,EAAE,MAAM,CAAA;KAAE;IAKrD;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAU/B;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAIjC;;OAEG;IACG,YAAY,CAChB,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,EACnE,YAAY,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,EACrD,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,OAAO,CAAC,UAAU,CAAC,GAC9D,OAAO,CAAC,WAAW,CAAC;IAyDvB;;OAEG;IACH,OAAO,CAAC,eAAe;IAWvB;;OAEG;YACW,oBAAoB;IAmBlC;;OAEG;YACW,gBAAgB;IAsB9B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAO1B;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAIlD;;OAEG;IACH,SAAS,IAAI,KAAK,EAAE;IAIpB;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;CA0BhC"}