@downcity/agent 1.1.32 → 1.1.43

package/bin/executor/Executor.js

@@ -0,0 +1,533 @@
+/**
+ * Executor：单个 session 的执行编排器。
+ *
+ * 关键点（中文）
+ * - SDK 对外对象叫 `Session`，这里是内部执行层。
+ * - 一个 Executor 只对应一个固定的 `sessionId`。
+ * - 负责 history 写入、run scope、executing 状态、Composer 编排与 tool-loop 执行。
+ */
+import { streamText } from "ai";
+import { SessionHistoryWriter } from "./composer/history/SessionHistoryWriter.js";
+import { withSessionRunScope } from "./SessionRunScope.js";
+import { buildSessionStepEventMessages } from "./messages/SessionStepEventMapper.js";
+import { JsonlSessionCompactionComposer } from "./composer/compaction/jsonl/JsonlSessionCompactionComposer.js";
+import { LocalSessionContextComposer } from "./composer/context/LocalSessionContextComposer.js";
+import { MAX_INCOMPLETE_RESPONSE_RECOVERIES, MAX_TEXT_ONLY_CONTINUATIONS, MAX_TOOL_LOOP_STEPS, buildIncompleteResponseRecoveryNudge, buildTextOnlyContinuationNudge, detectIncompleteResponse, detectTextOnlyContinuationReason, mergeAssistantUiMessages, summarizeStepForDebug, summarizeUiMessageForDebug, toInlinePreview, } from "./core-engine/CoreEngineSignals.js";
+import { evaluateCoreEngineLoopDecision, shouldContinueForTailMergedUserMessages, } from "./core-engine/CoreEngineLoopDecision.js";
+import { resolveEffectiveCoreEngineError, summarizeStreamError, } from "./core-engine/CoreEngineError.js";
+import { collectFinalAssistantMessageFromUiStream } from "./core-engine/CoreEngineUiStreamCollector.js";
+import { CoreEngineMessageState } from "./core-engine/CoreEngineMessageState.js";
+import { buildOpenAIResponsesProviderOptions, } from "./messages/SessionMessageCodec.js";
+import { logAssistantMessageNow } from "./messages/SessionMessageLog.js";
+/**
+ * 可压缩错误的最大重试次数。
+ */
+const MAX_COMPACTION_RETRY_ATTEMPTS = 3;
+/**
+ * Executor 单实例实现。
+ */
+export class Executor {
+    /**
+     * 当前 session 标识。
+     */
+    sessionId;
+    historyComposer;
+    historyStore;
+    getModel;
+    logger;
+    compactionComposer;
+    systemComposer;
+    contextComposer;
+    historyWriter;
+    executing = false;
+    retryCount = 0;
+    constructor(options) {
+        const sessionId = String(options.sessionId || "").trim();
+        if (!sessionId) {
+            throw new Error("Executor requires a non-empty sessionId");
+        }
+        this.sessionId = sessionId;
+        this.historyStore = options.historyStore;
+        this.historyComposer = options.historyComposer;
+        this.getModel = options.getModel;
+        this.logger = options.logger;
+        this.compactionComposer =
+            options.compactionComposer || new JsonlSessionCompactionComposer();
+        this.systemComposer = options.systemComposer;
+        this.contextComposer =
+            options.contextComposer ||
+                new LocalSessionContextComposer({
+                    sessionId: this.sessionId,
+                    getTools: options.getTools,
+                });
+        this.historyWriter = new SessionHistoryWriter({
+            sessionId,
+            getHistoryStore: () => this.getHistoryStore(),
+            runAfterSessionUpdated: options.runAfterSessionUpdated,
+        });
+    }
+    /**
+     * 返回当前 session 是否正在执行。
+     */
+    isExecuting() {
+        return this.executing;
+    }
+    /**
+     * 获取当前 session 的 history 事实源。
+     */
+    getHistoryStore() {
+        return this.historyStore;
+    }
+    /**
+     * 获取当前 session 的执行端口。
+     *
+     * 关键点（中文）
+     * - 兼容 runtime/service 端口语义：Executor 自己就是执行端口。
+     */
+    getExecutor() {
+        return this;
+    }
+    /**
+     * 清理当前 session 的执行器运行态。
+     *
+     * 关键点（中文）
+     * - 当前 Executor 不缓存模型实例，模型每轮 run 都从 `getModel()` 读取。
+     * - history 是事实源，不应随着执行态一起丢失。
+     */
+    clearExecutor() { }
+    /**
+     * 触发 session 更新后的异步回调。
+     */
+    async afterSessionUpdatedAsync() {
+        await this.historyWriter.afterSessionUpdatedAsync();
+    }
+    /**
+     * 追加一条 user 消息。
+     */
+    async appendUserMessage(params) {
+        await this.historyWriter.appendUserMessage(params);
+    }
+    /**
+     * 追加一条 assistant 消息。
+     */
+    async appendAssistantMessage(params) {
+        await this.historyWriter.appendAssistantMessage(params);
+    }
+    /**
+     * 运行当前 session 的一次请求。
+     *
+     * 关键点（中文）
+     * - 这里直接承接单个 Session 实例的一次 run 外层编排。
+     * - scope 绑定、assistant step 持久化、executing 状态都收在实例内部。
+     */
+    async run(params) {
+        if (this.executing) {
+            // 关键点（中文）：同一个 Session 实例只允许一个活跃 run，
+            // 否则 step 回调、scope 与执行器状态都会互相污染。
+            throw new Error("Executor.run does not support concurrent execution");
+        }
+        const query = String(params.query || "").trim();
+        const sessionRunScope = {
+            ...(typeof params.onStepCallback === "function"
+                ? { onStepCallback: params.onStepCallback }
+                : {}),
+            ...(typeof params.onAssistantStepCallback === "function"
+                ? { onAssistantStepCallback: params.onAssistantStepCallback }
+                : {}),
+            ...(typeof params.onUiMessageChunkCallback === "function"
+                ? { onUiMessageChunkCallback: params.onUiMessageChunkCallback }
+                : {}),
+        };
+        let persistedAssistantStepCount = 0;
+        const providedOnAssistantStepCallback = sessionRunScope.onAssistantStepCallback;
+        const wrappedOnAssistantStepCallback = async (step) => {
+            const stepMessages = buildSessionStepEventMessages({
+                sessionId: this.sessionId,
+                stepIndex: step.stepIndex,
+                stepResult: step.stepResult,
+                text: step.text,
+                visibility: step.visibility,
+            });
+            if (stepMessages.length > 0) {
+                for (const stepMessage of stepMessages) {
+                    await this.appendAssistantMessage({
+                        message: stepMessage,
+                    });
+                    persistedAssistantStepCount += 1;
+                }
+            }
+            if (typeof providedOnAssistantStepCallback === "function") {
+                await providedOnAssistantStepCallback(step);
+            }
+        };
+        this.executing = true;
+        this.resetRunState();
+        try {
+            const result = await withSessionRunScope({
+                sessionId: this.sessionId,
+                ...sessionRunScope,
+                onAssistantStepCallback: wrappedOnAssistantStepCallback,
+            }, () => this.runWithRetry({ query }));
+            if (persistedAssistantStepCount <= 0)
+                return result;
+            return {
+                ...result,
+                assistantMessage: {
+                    ...result.assistantMessage,
+                    metadata: {
+                        ...(result.assistantMessage.metadata || {
+                            v: 1,
+                            ts: Date.now(),
+                            sessionId: this.sessionId,
+                        }),
+                        extra: {
+                            ...(result.assistantMessage.metadata?.extra &&
+                                typeof result.assistantMessage.metadata.extra === "object" &&
+                                !Array.isArray(result.assistantMessage.metadata.extra)
+                                ? result.assistantMessage.metadata.extra
+                                : {}),
+                            assistantStepMessagesPersisted: true,
+                            assistantStepCount: persistedAssistantStepCount,
+                        },
+                    },
+                },
+            };
+        }
+        finally {
+            this.resetRunState();
+            this.executing = false;
+        }
+    }
+    /**
+     * 执行一次 session run（带可压缩错误重试）。
+     */
+    async runWithRetry(input) {
+        const model = this.resolveModelOrThrow();
+        try {
+            const query = String(input.query || "").trim();
+            const prepared = await this.prepareExecuteInput(query, model);
+            return await this.executePreparedRun(prepared, model);
+        }
+        catch (error) {
+            if (this.compactionComposer.shouldCompactOnError(error)) {
+                await this.logger.log("info", "[agent] compacting", {
+                    retryCount: this.retryCount,
+                    error: String(error),
+                });
+                if (this.retryCount < MAX_COMPACTION_RETRY_ATTEMPTS) {
+                    this.retryCount += 1;
+                    return this.runWithRetry(input);
+                }
+                return {
+                    success: false,
+                    error: "Context length exceeded and retries failed. Please resend your question.",
+                    assistantMessage: this.contextComposer.buildFallbackAssistantMessage("Context length exceeded and retries failed. Please resend your question."),
+                };
+            }
+            const errorMsg = String(error);
+            await this.logger.log("error", "Executor execution failed", {
+                error: errorMsg,
+            });
+            return {
+                success: false,
+                error: errorMsg,
+                assistantMessage: this.contextComposer.buildFallbackAssistantMessage(`Execution failed: ${errorMsg}`),
+            };
+        }
+    }
+    /**
+     * 调用 Composer 组装当前轮执行输入。
+     */
+    async prepareExecuteInput(query, model) {
+        if (!String(this.historyComposer.sessionId || "").trim()) {
+            throw new Error("Executor.run requires historyComposer.sessionId");
+        }
+        const runContext = await this.contextComposer.compose();
+        const tools = runContext.tools;
+        const system = await this.systemComposer.resolve();
+        try {
+            if (this.retryCount > 0) {
+                await this.logger.log("info", "[agent] compacting", {
+                    retryCount: this.retryCount,
+                });
+            }
+            await this.compactionComposer.run({
+                historyStore: this.historyStore,
+                model,
+                system,
+                retryCount: this.retryCount,
+            });
+        }
+        catch {
+            // 压缩失败不阻断主流程，继续使用当前历史消息执行。
+        }
+        const messages = await this.historyComposer.prepare({
+            query,
+            tools,
+            system,
+            model,
+            retryCount: this.retryCount,
+        });
+        return {
+            query,
+            system,
+            messages,
+            tools,
+        };
+    }
+    /**
+     * 执行一次已装配完成的运行材料。
+     */
+    async executePreparedRun(input, model) {
+        return await this.runCoreEngine(input, model);
+    }
+    /**
+     * 运行模型/tool-loop 核心。
+     *
+     * 关键点（中文）
+     * - CoreEngine 是 Executor 内部机制，不是第二个 Executor 实例。
+     * - 这里只返回最终 assistant message；是否写入长期 history 由外层 Session/Service 决定。
+     * - 运行中生成的内部续写 user message 只进入本轮内存态，不直接落盘。
+     */
+    async runCoreEngine(input, model) {
+        const startTime = Date.now();
+        const sessionId = String(this.historyStore.sessionId || "").trim();
+        const system = Array.isArray(input.system) ? input.system : [];
+        const tools = input.tools;
+        let lastObservedStreamError = undefined;
+        try {
+            const messageState = await CoreEngineMessageState.create({
+                messages: input.messages,
+                tools,
+            });
+            const appendMergedUserMessages = (messages) => messageState.appendMergedUserMessages(messages);
+            const contextComposerOnStepFinish = this.contextComposer.createOnStepFinishHandler();
+            let stepCount = 0;
+            let totalToolCallCount = 0;
+            let totalToolResultCount = 0;
+            const onStepFinish = async (stepResult) => {
+                stepCount += 1;
+                const summary = summarizeStepForDebug(stepResult);
+                totalToolCallCount +=
+                    typeof summary.toolCallCount === "number" ? summary.toolCallCount : 0;
+                totalToolResultCount +=
+                    typeof summary.toolResultCount === "number"
+                        ? summary.toolResultCount
+                        : 0;
+                await this.logger.log("info", "[agent] step.finish", {
+                    sessionId,
+                    stepIndex: stepCount,
+                    ...summary,
+                });
+                await contextComposerOnStepFinish(stepResult);
+            };
+            const prepareStep = this.contextComposer.createPrepareStepHandler({
+                system,
+                appendMergedUserMessages,
+            });
+            let finalAssistantUiMessage = null;
+            let textOnlyContinuationCount = 0;
+            let incompleteResponseRecoveryCount = 0;
+            while (stepCount < MAX_TOOL_LOOP_STEPS) {
+                const result = streamText({
+                    model,
+                    system,
+                    onStepFinish,
+                    prepareStep,
+                    messages: messageState.modelMessages,
+                    tools,
+                    providerOptions: buildOpenAIResponsesProviderOptions(),
+                    onError: async ({ error }) => {
+                        lastObservedStreamError = error;
+                        await this.logger.log("error", "[agent] stream.error", {
+                            sessionId,
+                            ...summarizeStreamError(error),
+                        });
+                    },
+                });
+                const stepAssistantUiMessage = await collectFinalAssistantMessageFromUiStream({
+                    result,
+                    sessionId,
+                    logger: this.logger,
+                    buildFallbackAssistantMessage: (text) => this.contextComposer.buildFallbackAssistantMessage(text),
+                });
+                const executedSteps = await result.steps;
+                const lastStep = executedSteps[executedSteps.length - 1];
+                if (!lastStep)
+                    break;
+                const incompleteResponse = detectIncompleteResponse({
+                    stepResult: lastStep,
+                    assistantMessage: stepAssistantUiMessage,
+                });
+                const textOnlyContinuationReason = detectTextOnlyContinuationReason(lastStep);
+                const loopDecision = evaluateCoreEngineLoopDecision({
+                    hasIncompleteResponse: incompleteResponse !== null,
+                    incompleteRecoveryCount: incompleteResponseRecoveryCount,
+                    maxIncompleteRecoveries: MAX_INCOMPLETE_RESPONSE_RECOVERIES,
+                    textOnlyContinuationReason,
+                    textOnlyContinuationCount,
+                    maxTextOnlyContinuations: MAX_TEXT_ONLY_CONTINUATIONS,
+                    hasTools: Object.keys(tools).length > 0,
+                    toolCallCount: lastStep.toolCalls.length,
+                });
+                await this.logger.log("info", "[agent] loop.decision", {
+                    sessionId,
+                    stepIndex: stepCount,
+                    continueForToolCalls: loopDecision.continueForToolCalls,
+                    continueForTextOnly: loopDecision.continueForTextOnly,
+                    continueForIncompleteRecovery: loopDecision.continueForIncompleteRecovery,
+                    decisionKind: loopDecision.kind,
+                    textOnlyContinuationReason,
+                    textOnlyContinuationCount,
+                    incompleteResponseReason: incompleteResponse?.reason ?? null,
+                    incompleteResponseRecoveryCount,
+                    toolCallCount: lastStep.toolCalls.length,
+                    toolResultCount: lastStep.toolResults.length,
+                    finishReason: lastStep.finishReason,
+                    textPreview: toInlinePreview(lastStep.text),
+                });
+                if (loopDecision.continueForIncompleteRecovery && incompleteResponse) {
+                    incompleteResponseRecoveryCount += 1;
+                    await this.logger.log("warn", "[agent] incomplete_response.recover", {
+                        sessionId,
+                        stepIndex: stepCount,
+                        recoveryCount: incompleteResponseRecoveryCount,
+                        reason: incompleteResponse.reason,
+                        ...incompleteResponse.details,
+                    });
+                    const recoveryMessage = this.historyStore.userText({
+                        text: buildIncompleteResponseRecoveryNudge(incompleteResponseRecoveryCount),
+                        metadata: {
+                            sessionId,
+                            extra: {
+                                internal: "agent_incomplete_response_recover",
+                                reason: incompleteResponse.reason,
+                                stepIndex: stepCount,
+                            },
+                        },
+                    });
+                    await messageState.appendUserTextMessage(recoveryMessage);
+                    continue;
+                }
+                if (incompleteResponse) {
+                    await this.logger.log("error", "[agent] incomplete_response", {
+                        sessionId,
+                        stepIndex: stepCount,
+                        reason: incompleteResponse.reason,
+                        recoveryCount: incompleteResponseRecoveryCount,
+                        ...incompleteResponse.details,
+                    });
+                    throw new Error(`Agent received incomplete response (${incompleteResponse.reason})`);
+                }
+                const responseMessages = Array.isArray(lastStep.response?.messages)
+                    ? lastStep.response.messages
+                    : [];
+                messageState.appendModelMessages(responseMessages);
+                finalAssistantUiMessage = mergeAssistantUiMessages(finalAssistantUiMessage, stepAssistantUiMessage);
+                // 关键点（中文）：把本 step 的 assistant UI 消息并入运行时上下文，保证后续全量重算不丢历史。
+                messageState.appendRuntimeSessionMessage(stepAssistantUiMessage);
+                if (loopDecision.continueForToolCalls) {
+                    textOnlyContinuationCount = 0;
+                    incompleteResponseRecoveryCount = 0;
+                    continue;
+                }
+                if (loopDecision.continueForTextOnly) {
+                    textOnlyContinuationCount += 1;
+                    incompleteResponseRecoveryCount = 0;
+                    const continuationMessage = this.historyStore.userText({
+                        text: buildTextOnlyContinuationNudge(textOnlyContinuationCount),
+                        metadata: {
+                            sessionId,
+                            extra: {
+                                internal: "agent_loop_auto_continue",
+                                reason: textOnlyContinuationReason,
+                                stepIndex: stepCount,
+                            },
+                        },
+                    });
+                    await messageState.appendUserTextMessage(continuationMessage);
+                    continue;
+                }
+                // 关键点（中文）：stop 前做 tail merge，覆盖最后一个 step 后才入队的新 user 消息。
+                const tailPrepared = await prepareStep({ messages: [] });
+                const tailMergedMessageCount = Array.isArray(tailPrepared.messages)
+                    ? tailPrepared.messages.length
+                    : 0;
+                if (shouldContinueForTailMergedUserMessages({
+                    mergedUserMessageCount: tailMergedMessageCount,
+                })) {
+                    textOnlyContinuationCount = 0;
+                    incompleteResponseRecoveryCount = 0;
+                    await this.logger.log("info", "[agent] loop.tail_merge_continue", {
+                        sessionId,
+                        stepIndex: stepCount,
+                        mergedUserMessageCount: tailMergedMessageCount,
+                    });
+                    continue;
+                }
+                break;
+            }
+            if (stepCount >= MAX_TOOL_LOOP_STEPS) {
+                await this.logger.log("warn", "[agent] loop.max_steps_reached", {
+                    sessionId,
+                    stepCount,
+                    totalToolCallCount,
+                    totalToolResultCount,
+                });
+            }
+            const finalMessage = finalAssistantUiMessage ||
+                this.contextComposer.buildFallbackAssistantMessage("Execution completed");
+            await this.logger.log("info", "[agent] final.message", {
+                sessionId,
+                ...summarizeUiMessageForDebug(finalMessage),
+            });
+            await logAssistantMessageNow(this.logger, finalMessage);
+            const duration = Date.now() - startTime;
+            await this.logger.log("info", "[agent] finish", {
+                sessionId,
+                duration,
+                stepCount,
+                totalToolCallCount,
+                totalToolResultCount,
+            });
+            return {
+                success: true,
+                assistantMessage: finalMessage,
+            };
+        }
+        catch (error) {
+            if (this.compactionComposer.shouldCompactOnError(error)) {
+                throw error;
+            }
+            const errorMsg = resolveEffectiveCoreEngineError({
+                error,
+                streamError: lastObservedStreamError,
+            });
+            await this.logger.log("error", "CoreEngine execution failed", {
+                error: errorMsg,
+            });
+            return {
+                success: false,
+                error: errorMsg,
+                assistantMessage: this.contextComposer.buildFallbackAssistantMessage(`Execution failed: ${errorMsg}`),
+            };
+        }
+    }
+    /**
+     * 读取当前 session 模型。
+     */
+    resolveModelOrThrow() {
+        const model = this.getModel();
+        if (!model) {
+            throw new Error(`Executor for session "${this.sessionId}" requires a configured model. Pass model to new Agent({ model }) or call session.set({ model }) before execution.`);
+        }
+        return model;
+    }
+    /**
+     * 重置当前 run 级状态。
+     */
+    resetRunState() {
+        this.retryCount = 0;
+    }
+}
+//# sourceMappingURL=Executor.js.map

package/bin/executor/Executor.js.map

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

package/bin/executor/SessionRunScope.d.ts

@@ -0,0 +1,84 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+import type { SessionUserMessageV1 } from "../executor/types/SessionMessages.js";
+import type { SessionAssistantStepCallback, SessionUiMessageChunkCallback } from "../executor/types/SessionRun.js";
+/**
+ * SessionRunScope（单次请求作用域）。
+ *
+ * 关键点（中文）
+ * - 这是 session run 层请求作用域上下文，不属于具体 plugin 业务模块。
+ * - 统一承载请求链需要透传的字段（如 `sessionId`）。
+ */
+export type SessionRunScope = {
+    sessionId?: string;
+    /**
+     * step 边界合并回调（可选）。
+     *
+     * 关键点（中文）
+     * - 由调用侧（如 chat queue）注入。
+     * - Orchestrator 从 SessionRunScope 读取并编排到本轮运行上下文。
+     */
+    onStepCallback?: () => Promise<SessionUserMessageV1[]>;
+    /**
+     * assistant step 完成回调（可选）。
+     *
+     * 关键点（中文）
+     * - 在每个 LLM step 结束时触发。
+     * - 用于把中间文本增量派发到外部通道（如 direct 模式分步发送）。
+     */
+    onAssistantStepCallback?: SessionAssistantStepCallback;
+    /**
+     * UI stream chunk 回调（可选）。
+     *
+     * 关键点（中文）
+     * - 用于把底层模型 UI stream 事件向上层 SDK / transport 旁路输出。
+     * - 不影响最终 assistantMessage 的收敛与落盘。
+     */
+    onUiMessageChunkCallback?: SessionUiMessageChunkCallback;
+    /**
+     * 运行时注入的 user 消息队列（可选）。
+     *
+     * 关键点（中文）
+     * - 用于在 tool 执行后向下一 step 注入结构化 user 消息。
+     * - 队列内容由上层 plugin runtime 通过统一协议下发，main 不感知业务语义。
+     */
+    injectedUserMessages?: SessionUserMessageV1[];
+};
+/**
+ * AsyncLocalStorage 容器（请求作用域）。
+ *
+ * 关键点（中文）
+ * - 同一条异步调用链内可读取一致的 SessionRunScope。
+ * - 用于把 `sessionId` 从入口透传到 plugin runtime 与工具层。
+ */
+export declare const sessionRunScopeStorage: AsyncLocalStorage<SessionRunScope>;
+/**
+ * 在当前异步调用链内绑定 session run 作用域。
+ */
+export declare function withSessionRunScope<T>(ctx: SessionRunScope, fn: () => T): T;
+/**
+ * 读取当前异步链路上的 session run 作用域。
+ */
+export declare function getSessionRunScope(): SessionRunScope | undefined;
+/**
+ * 入队一条“待注入 user 消息”。
+ *
+ * 关键点（中文）
+ * - 若当前不在 session run 作用域内，静默忽略（fail-open）。
+ */
+export declare function enqueueInjectedUserMessage(message: SessionUserMessageV1): void;
+/**
+ * 读取并清空“待注入 user 消息”队列。
+ *
+ * 关键点（中文）
+ * - 采用 drain 语义，确保每条注入消息只在下一 step 使用一次。
+ */
+export declare function drainInjectedUserMessages(): SessionUserMessageV1[];
+/**
+ * 入队一条“待持久化 user 消息”。
+ */
+export declare function enqueueDeferredPersistedUserMessage(sessionId: string, message: SessionUserMessageV1): void;
+/**
+ * 读取并清空指定 session 的待持久化 user 消息。
+ */
+export declare function drainDeferredPersistedUserMessages(sessionId: string): SessionUserMessageV1[];
+//# sourceMappingURL=SessionRunScope.d.ts.map

package/bin/executor/SessionRunScope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionRunScope.d.ts","sourceRoot":"","sources":["../../src/executor/SessionRunScope.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAChF,OAAO,KAAK,EACV,4BAA4B,EAC5B,6BAA6B,EAC9B,MAAM,gCAAgC,CAAC;AAExC;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAAC;IAEvD;;;;;;OAMG;IACH,uBAAuB,CAAC,EAAE,4BAA4B,CAAC;IAEvD;;;;;;OAMG;IACH,wBAAwB,CAAC,EAAE,6BAA6B,CAAC;IAEzD;;;;;;OAMG;IACH,oBAAoB,CAAC,EAAE,oBAAoB,EAAE,CAAC;CAC/C,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,oCAA2C,CAAC;AAe/E;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,GAAG,EAAE,eAAe,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAE3E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,eAAe,GAAG,SAAS,CAEhE;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,oBAAoB,GAC5B,IAAI,CAON;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,IAAI,oBAAoB,EAAE,CAMlE;AAED;;GAEG;AACH,wBAAgB,mCAAmC,CACjD,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,oBAAoB,GAC5B,IAAI,CAMN;AAED;;GAEG;AACH,wBAAgB,kCAAkC,CAChD,SAAS,EAAE,MAAM,GAChB,oBAAoB,EAAE,CAMxB"}