llm-content-creator 0.1.0

package/dist/domain/workflow/State.js

@@ -0,0 +1,184 @@
+/**
+ * Workflow State - 工作流状态定义
+ *
+ * 定义 LangGraph 工作流的状态结构
+ * 每个节点接收完整的 State，返回要更新的字段（Partial<State>）
+ */
+import { ExecutionMode } from '../entities/Task.js';
+// 重新导出 ExecutionMode 以便外部使用
+export { ExecutionMode };
+/**
+ * 创建初始状态
+ */
+export function createInitialState(params) {
+    return {
+        taskId: params.taskId,
+        mode: params.mode,
+        topic: params.topic,
+        requirements: params.requirements,
+        hardConstraints: params.hardConstraints || {},
+        currentStep: 'start',
+        textRetryCount: 0,
+        imageRetryCount: 0,
+        version: 1, // 初始版本号
+        startTime: Date.now(),
+    };
+}
+/**
+ * 状态更新辅助函数
+ */
+export class StateUpdater {
+    /**
+     * 创建状态更新（类型安全的 Partial）
+     */
+    static update(field, value) {
+        return { [field]: value };
+    }
+    /**
+     * 批量更新状态
+     */
+    static updates(updates) {
+        return updates;
+    }
+    /**
+     * 更新当前步骤
+     */
+    static updateStep(stepName) {
+        return {
+            currentStep: stepName,
+        };
+    }
+    /**
+     * 增加重试计数
+     */
+    static incrementTextRetry(state) {
+        return {
+            textRetryCount: state.textRetryCount + 1,
+        };
+    }
+    static incrementImageRetry(state) {
+        return {
+            imageRetryCount: state.imageRetryCount + 1,
+        };
+    }
+    /**
+     * 标记错误
+     */
+    static markError(error) {
+        return {
+            error,
+            endTime: Date.now(),
+        };
+    }
+    /**
+     * 标记完成
+     */
+    static markComplete() {
+        return {
+            currentStep: 'complete',
+            endTime: Date.now(),
+        };
+    }
+}
+/**
+ * 状态验证工具
+ */
+export class StateValidator {
+    /**
+     * 验证状态是否可序列化
+     */
+    static validateSerializable(state) {
+        try {
+            JSON.stringify(state);
+            return true;
+        }
+        catch (error) {
+            console.error('State is not serializable:', error);
+            return false;
+        }
+    }
+    /**
+     * 验证必需字段
+     */
+    static validateRequired(state) {
+        const required = [
+            'taskId',
+            'mode',
+            'topic',
+            'requirements',
+            'hardConstraints',
+            'currentStep',
+            'textRetryCount',
+            'imageRetryCount',
+            'version',
+        ];
+        for (const field of required) {
+            if (state[field] === undefined || state[field] === null) {
+                console.error(`Missing required field: ${field}`);
+                return false;
+            }
+        }
+        return true;
+    }
+    /**
+     * 验证状态完整性
+     */
+    static validate(state) {
+        return this.validateSerializable(state) && this.validateRequired(state);
+    }
+}
+/**
+ * State 快照管理
+ */
+export class StateSnapshotManager {
+    /**
+     * 序列化状态
+     */
+    static serialize(state) {
+        if (!StateValidator.validateSerializable(state)) {
+            throw new Error('State is not serializable');
+        }
+        return JSON.stringify(state);
+    }
+    /**
+     * 反序列化状态
+     */
+    static deserialize(json) {
+        try {
+            const state = JSON.parse(json);
+            if (!StateValidator.validate(state)) {
+                throw new Error('Invalid state structure');
+            }
+            return state;
+        }
+        catch (error) {
+            console.error('Failed to deserialize state:', error);
+            throw error;
+        }
+    }
+    /**
+     * 克隆状态（深拷贝）
+     */
+    static clone(state) {
+        return JSON.parse(JSON.stringify(state));
+    }
+    /**
+     * 创建检查点快照（只保存必要字段）
+     */
+    static createCheckpoint(state) {
+        return {
+            searchResults: state.searchResults,
+            organizedInfo: state.organizedInfo,
+            articleContent: state.articleContent,
+            imagePrompts: state.imagePrompts,
+            images: state.images,
+            textQualityReport: state.textQualityReport,
+            imageQualityReport: state.imageQualityReport,
+            currentStep: state.currentStep,
+            textRetryCount: state.textRetryCount,
+            imageRetryCount: state.imageRetryCount,
+            version: state.version,
+        };
+    }
+}
+//# sourceMappingURL=State.js.map

package/dist/domain/workflow/State.js.map

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

package/dist/domain/workflow/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Workflow 层导出
+ *
+ * 统一导出所有工作流相关的类和接口
+ */
+export * from './State.js';
+export * from './nodes/BaseNode.js';
+export * from './nodes/index.js';
+export * from './CheckpointManager.js';
+export * from './ContentCreatorGraph.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/domain/workflow/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/domain/workflow/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,YAAY,CAAC;AAG3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,wBAAwB,CAAC;AAGvC,cAAc,0BAA0B,CAAC"}

package/dist/domain/workflow/index.js

@@ -0,0 +1,15 @@
+/**
+ * Workflow 层导出
+ *
+ * 统一导出所有工作流相关的类和接口
+ */
+// State
+export * from './State.js';
+// Nodes
+export * from './nodes/BaseNode.js';
+export * from './nodes/index.js';
+// Checkpoint Manager
+export * from './CheckpointManager.js';
+// Graph
+export * from './ContentCreatorGraph.js';
+//# sourceMappingURL=index.js.map

package/dist/domain/workflow/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/domain/workflow/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,QAAQ;AACR,cAAc,YAAY,CAAC;AAE3B,QAAQ;AACR,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AAEjC,qBAAqB;AACrB,cAAc,wBAAwB,CAAC;AAEvC,QAAQ;AACR,cAAc,0BAA0B,CAAC"}

package/dist/domain/workflow/nodes/BaseNode.d.ts

@@ -0,0 +1,134 @@
+/**
+ * BaseNode - 节点基类
+ *
+ * 所有工作流节点的基类，提供通用功能：
+ * - 错误处理
+ * - Token 记录
+ * - 日志记录
+ * - 状态验证
+ * - 重试支持
+ */
+import type { WorkflowState } from '../State.js';
+/**
+ * 节点执行结果
+ */
+export interface NodeResult {
+    success: boolean;
+    stateUpdate: Partial<WorkflowState>;
+    error?: string;
+    tokenUsage?: {
+        tokensIn: number;
+        tokensOut: number;
+        totalTokens: number;
+    };
+    duration: number;
+}
+/**
+ * 节点配置
+ */
+export interface NodeConfig {
+    name: string;
+    retryCount?: number;
+    timeout?: number;
+}
+/**
+ * 节点基类
+ */
+export declare abstract class BaseNode {
+    protected readonly name: string;
+    protected readonly retryCount: number;
+    protected readonly timeout: number;
+    protected readonly logger: import("../../../infrastructure/logging/logger.js").Logger;
+    constructor(config: NodeConfig);
+    /**
+     * 执行节点（带重试和错误处理）
+     *
+     * @param state - 当前工作流状态
+     * @returns 节点执行结果
+     */
+    execute(state: WorkflowState): Promise<NodeResult>;
+    /**
+     * 抽象方法：节点具体逻辑（由子类实现）
+     *
+     * @param state - 当前工作流状态
+     * @returns 状态更新（Partial<WorkflowState>）
+     */
+    protected abstract executeLogic(state: WorkflowState): Promise<Partial<WorkflowState>>;
+    /**
+     * 验证状态（可选，由子类重写）
+     *
+     * @param state - 当前工作流状态
+     * @throws Error 如果状态无效
+     */
+    protected validateState(state: WorkflowState): void;
+    /**
+     * 获取当前尝试次数（可选，由子类重写）
+     *
+     * @param state - 当前工作流状态
+     * @returns 尝试次数
+     */
+    protected getAttemptCount(_state: WorkflowState): number;
+    /**
+     * 执行节点逻辑（带超时控制）
+     *
+     * @param state - 当前工作流状态
+     * @returns 状态更新
+     */
+    private executeWithTimeout;
+    /**
+     * 创建超时 Promise
+     */
+    private createTimeoutPromise;
+    /**
+     * 记录 LLM Token 使用（可选，由子类调用）
+     *
+     * @param state - 工作流状态
+     * @param tokensIn - 输入 Token 数量
+     * @param tokensOut - 输出 Token 数量
+     */
+    protected recordTokenUsage(state: WorkflowState, tokensIn: number, tokensOut: number): void;
+    /**
+     * 创建状态更新辅助函数
+     */
+    protected updateState<T extends keyof WorkflowState>(field: T, value: WorkflowState[T]): Partial<WorkflowState>;
+    /**
+     * 转换为 LangGraph 节点
+     *
+     * @returns LangGraph 节点函数
+     */
+    toLangGraphNode(): (state: WorkflowState) => Promise<Partial<WorkflowState>>;
+}
+/**
+ * 节点执行上下文
+ *
+ * 提供额外的工具和方法供节点使用
+ */
+export declare class NodeContext {
+    protected readonly logger: import("../../../infrastructure/logging/logger.js").Logger;
+    constructor(nodeName: string);
+    /**
+     * 生成 Trace ID（用于链路追踪）
+     */
+    generateTraceId(): string;
+    /**
+     * 延迟执行（毫秒）
+     */
+    delay(ms: number): Promise<void>;
+    /**
+     * 计算文本的 Token 数量（估算）
+     */
+    estimateTokens(text: string): number;
+    /**
+     * 截断文本到指定 Token 数量
+     */
+    truncateToTokens(text: string, maxTokens: number): string;
+    /**
+     * 安全地解析 JSON
+     */
+    safeParseJSON<T>(json: string, fallback: T): T;
+    /**
+     * 格式化错误消息
+     */
+    formatError(error: unknown): string;
+}
+//# sourceMappingURL=BaseNode.d.ts.map

package/dist/domain/workflow/nodes/BaseNode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseNode.d.ts","sourceRoot":"","sources":["../../../../src/domain/workflow/nodes/BaseNode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAKjD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE;QACX,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,8BAAsB,QAAQ;IAC5B,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAChC,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IACtC,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACnC,SAAS,CAAC,QAAQ,CAAC,MAAM,6DAAC;gBAEd,MAAM,EAAE,UAAU;IAO9B;;;;;OAKG;IACG,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC;IA4DxD;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,CAAC,YAAY,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IAEtF;;;;;OAKG;IACH,SAAS,CAAC,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAOnD;;;;;OAKG;IACH,SAAS,CAAC,eAAe,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM;IAMxD;;;;;OAKG;YACW,kBAAkB;IAOhC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAQ5B;;;;;;OAMG;IACH,SAAS,CAAC,gBAAgB,CACxB,KAAK,EAAE,aAAa,EACpB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAChB,IAAI;IAuBP;;OAEG;IACH,SAAS,CAAC,WAAW,CAAC,CAAC,SAAS,MAAM,aAAa,EACjD,KAAK,EAAE,CAAC,EACR,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,GACtB,OAAO,CAAC,aAAa,CAAC;IAIzB;;;;OAIG;IACH,eAAe,IAAI,CAAC,KAAK,EAAE,aAAa,KAAK,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;CAkB7E;AAED;;;;GAIG;AACH,qBAAa,WAAW;IACtB,SAAS,CAAC,QAAQ,CAAC,MAAM,6DAAC;gBAEd,QAAQ,EAAE,MAAM;IAI5B;;OAEG;IACH,eAAe,IAAI,MAAM;IAIzB;;OAEG;IACG,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAItC;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAQpC;;OAEG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM;IAazD;;OAEG;IACH,aAAa,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC;IAW9C;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM;CAMpC"}

package/dist/domain/workflow/nodes/BaseNode.js

@@ -0,0 +1,253 @@
+/**
+ * BaseNode - 节点基类
+ *
+ * 所有工作流节点的基类，提供通用功能：
+ * - 错误处理
+ * - Token 记录
+ * - 日志记录
+ * - 状态验证
+ * - 重试支持
+ */
+import { createLogger } from '../../../infrastructure/logging/logger.js';
+const logger = createLogger('BaseNode');
+/**
+ * 节点基类
+ */
+export class BaseNode {
+    name;
+    retryCount;
+    timeout;
+    logger;
+    constructor(config) {
+        this.name = config.name;
+        this.retryCount = config.retryCount ?? 0;
+        this.timeout = config.timeout ?? 60000; // 60 秒默认超时
+        this.logger = createLogger(`Node:${this.name}`);
+    }
+    /**
+     * 执行节点（带重试和错误处理）
+     *
+     * @param state - 当前工作流状态
+     * @returns 节点执行结果
+     */
+    async execute(state) {
+        const startTime = Date.now();
+        const attempt = this.getAttemptCount(state);
+        this.logger.info('Node execution started', {
+            nodeId: this.name,
+            taskId: state.taskId,
+            attempt: attempt + 1,
+        });
+        try {
+            // 验证状态
+            this.validateState(state);
+            // 执行节点逻辑（带超时）
+            const stateUpdate = await this.executeWithTimeout(state);
+            // 计算执行时长
+            const duration = Date.now() - startTime;
+            // 记录成功日志
+            this.logger.info('Node execution completed', {
+                nodeId: this.name,
+                taskId: state.taskId,
+                duration,
+            });
+            // 返回结果
+            return {
+                success: true,
+                stateUpdate: {
+                    ...stateUpdate,
+                    currentStep: this.name,
+                },
+                duration,
+            };
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            // 记录错误日志
+            this.logger.error('Node execution failed', {
+                nodeId: this.name,
+                taskId: state.taskId,
+                error: errorMessage,
+                duration,
+            });
+            // 返回错误结果
+            return {
+                success: false,
+                stateUpdate: {
+                    error: errorMessage,
+                },
+                error: errorMessage,
+                duration,
+            };
+        }
+    }
+    /**
+     * 验证状态（可选，由子类重写）
+     *
+     * @param state - 当前工作流状态
+     * @throws Error 如果状态无效
+     */
+    validateState(state) {
+        // 默认验证：检查是否有错误
+        if (state.error) {
+            throw new Error(`Previous error: ${state.error}`);
+        }
+    }
+    /**
+     * 获取当前尝试次数（可选，由子类重写）
+     *
+     * @param state - 当前工作流状态
+     * @returns 尝试次数
+     */
+    getAttemptCount(_state) {
+        // 默认：返回 0
+        // 子类可以根据 state 中的重试计数器返回实际值
+        return 0;
+    }
+    /**
+     * 执行节点逻辑（带超时控制）
+     *
+     * @param state - 当前工作流状态
+     * @returns 状态更新
+     */
+    async executeWithTimeout(state) {
+        return Promise.race([
+            this.executeLogic(state),
+            this.createTimeoutPromise(),
+        ]);
+    }
+    /**
+     * 创建超时 Promise
+     */
+    createTimeoutPromise() {
+        return new Promise((_, reject) => {
+            setTimeout(() => {
+                reject(new Error(`Node timeout: ${this.name} exceeded ${this.timeout}ms`));
+            }, this.timeout);
+        });
+    }
+    /**
+     * 记录 LLM Token 使用（可选，由子类调用）
+     *
+     * @param state - 工作流状态
+     * @param tokensIn - 输入 Token 数量
+     * @param tokensOut - 输出 Token 数量
+     */
+    recordTokenUsage(state, tokensIn, tokensOut) {
+        this.logger.debug('Token usage recorded', {
+            nodeId: this.name,
+            taskId: state.taskId,
+            tokensIn,
+            tokensOut,
+            totalTokens: tokensIn + tokensOut,
+        });
+        // TODO: 保存到数据库（后续实现）
+        // await tokenUsageRepo.create({
+        //   taskId: state.taskId,
+        //   traceId: generateTraceId(),
+        //   stepName: this.name,
+        //   apiName: 'deepseek',
+        //   modelName: 'deepseek-chat',
+        //   tokensIn,
+        //   tokensOut,
+        //   totalTokens: tokensIn + tokensOut,
+        //   ...
+        // });
+    }
+    /**
+     * 创建状态更新辅助函数
+     */
+    updateState(field, value) {
+        return { [field]: value };
+    }
+    /**
+     * 转换为 LangGraph 节点
+     *
+     * @returns LangGraph 节点函数
+     */
+    toLangGraphNode() {
+        return async (state) => {
+            logger.debug(`Node ${this.name} received state`, {
+                taskId: state.taskId,
+                topic: state.topic,
+                hasTopic: !!state.topic,
+                stateKeys: Object.keys(state),
+            });
+            const result = await this.execute(state);
+            if (!result.success) {
+                throw new Error(result.error || 'Node execution failed');
+            }
+            return result.stateUpdate;
+        };
+    }
+}
+/**
+ * 节点执行上下文
+ *
+ * 提供额外的工具和方法供节点使用
+ */
+export class NodeContext {
+    logger;
+    constructor(nodeName) {
+        this.logger = createLogger(`Node:${nodeName}`);
+    }
+    /**
+     * 生成 Trace ID（用于链路追踪）
+     */
+    generateTraceId() {
+        return `${Date.now()}-${Math.random().toString(36).substring(2, 15)}`;
+    }
+    /**
+     * 延迟执行（毫秒）
+     */
+    async delay(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+    /**
+     * 计算文本的 Token 数量（估算）
+     */
+    estimateTokens(text) {
+        // 粗略估算：英文约 4 字符/token，中文约 1.5 字符/token
+        const chineseChars = (text.match(/[\u4e00-\u9fa5]/g) || []).length;
+        const englishChars = text.length - chineseChars;
+        return Math.ceil(chineseChars / 1.5 + englishChars / 4);
+    }
+    /**
+     * 截断文本到指定 Token 数量
+     */
+    truncateToTokens(text, maxTokens) {
+        const estimatedTokens = this.estimateTokens(text);
+        if (estimatedTokens <= maxTokens) {
+            return text;
+        }
+        // 粗略截断：按比例缩短
+        const ratio = maxTokens / estimatedTokens;
+        const truncatedLength = Math.floor(text.length * ratio);
+        return text.substring(0, truncatedLength);
+    }
+    /**
+     * 安全地解析 JSON
+     */
+    safeParseJSON(json, fallback) {
+        try {
+            return JSON.parse(json);
+        }
+        catch (error) {
+            this.logger.warn('Failed to parse JSON, using fallback', {
+                error: error instanceof Error ? error.message : String(error),
+            });
+            return fallback;
+        }
+    }
+    /**
+     * 格式化错误消息
+     */
+    formatError(error) {
+        if (error instanceof Error) {
+            return error.message;
+        }
+        return String(error);
+    }
+}
+//# sourceMappingURL=BaseNode.js.map

package/dist/domain/workflow/nodes/BaseNode.js.map

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

package/dist/domain/workflow/nodes/CheckImageNode.d.ts

@@ -0,0 +1,43 @@
+/**
+ * CheckImage Node - 配图质检节点
+ *
+ * 对生成的配图进行质量检查
+ */
+import { BaseNode } from './BaseNode.js';
+import type { WorkflowState } from '../State.js';
+/**
+ * CheckImage Node 配置
+ */
+interface CheckImageNodeConfig {
+    minPassingScore?: number;
+    scoreWeights?: {
+        relevance: number;
+        aesthetic: number;
+        promptMatch: number;
+    };
+}
+/**
+ * CheckImage Node 实现
+ */
+export declare class CheckImageNode extends BaseNode {
+    private config;
+    constructor(config?: CheckImageNodeConfig);
+    /**
+     * 调用 LLM 评估单张图片
+     */
+    private evaluateImage;
+    /**
+     * 执行质检逻辑
+     */
+    protected executeLogic(state: WorkflowState): Promise<Partial<WorkflowState>>;
+    /**
+     * 验证输入状态
+     */
+    protected validateState(state: WorkflowState): void;
+}
+/**
+ * CheckImage Node 单例导出（默认配置）
+ */
+export declare const checkImageNode: CheckImageNode;
+export {};
+//# sourceMappingURL=CheckImageNode.d.ts.map

package/dist/domain/workflow/nodes/CheckImageNode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CheckImageNode.d.ts","sourceRoot":"","sources":["../../../../src/domain/workflow/nodes/CheckImageNode.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAoEjD;;GAEG;AACH,UAAU,oBAAoB;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,QAAQ;IAC1C,OAAO,CAAC,MAAM,CAAuB;gBAEzB,MAAM,GAAE,oBAAyB;IAkB7C;;OAEG;YACW,aAAa;IAyE3B;;OAEG;cACa,YAAY,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IAwHnF;;OAEG;IACH,SAAS,CAAC,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;CAMpD;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,gBAAuB,CAAC"}