@downcity/agent 1.1.74 → 1.1.81

package/bin/session/services/SessionStateService.js

@@ -0,0 +1,242 @@
+/**
+ * SessionStateService：本地 Session 状态与持久化服务。
+ *
+ * 关键点（中文）
+ * - 统一管理本地 Session 的初始化、配置、标题、metadata 与消息持久化。
+ * - 该服务只关心状态事实源与持久化副作用，不负责 turn 编排。
+ * - `Session` facade 与 turn/view service 都通过它访问可变 session 运行态。
+ */
+import { inferAgentModelLabel, normalizeAgentModel, } from "../../model/CityModelAdapter.js";
+import { patchSessionModelLabel, readSessionMetadata, resolveSystemTimezone, touchSessionMetadata, writeSessionMetadata, } from "../../session/index.js";
+import { ensureSessionTitle } from "../../session/SessionTitle.js";
+import { persistSdkAssistantResult } from "../../session/storage/Persistence.js";
+/**
+ * 本地 Session 状态与持久化服务。
+ */
+export class SessionStateService {
+    agent_id;
+    project_root;
+    session_id;
+    history_store;
+    executor;
+    state;
+    ensure_configured_hook;
+    publish_event;
+    constructor(options) {
+        this.agent_id = options.agent_id;
+        this.project_root = options.project_root;
+        this.session_id = options.session_id;
+        this.history_store = options.history_store;
+        this.executor = options.executor;
+        this.state = options.state;
+        this.ensure_configured_hook = options.ensure_configured_hook;
+        this.publish_event = options.publish_event;
+    }
+    /**
+     * 读取当前 session 配置快照。
+     */
+    get_config() {
+        return {
+            ...this.state.sessionConfig,
+        };
+    }
+    /**
+     * 读取当前 session 创建时间。
+     */
+    get_created_at() {
+        return this.state.createdAt;
+    }
+    /**
+     * 读取当前 session 参考时区。
+     */
+    get_timezone() {
+        return this.state.timezone;
+    }
+    /**
+     * 初始化当前 session metadata 与内存快照。
+     */
+    async initialize() {
+        if (this.state.initializePromise) {
+            await this.state.initializePromise;
+            return;
+        }
+        this.state.initializePromise = (async () => {
+            const metadata = await readSessionMetadata({
+                projectRoot: this.project_root,
+                agentId: this.agent_id,
+                sessionId: this.session_id,
+            });
+            const created_at = typeof metadata.createdAt === "number" ? metadata.createdAt : Date.now();
+            const timezone = typeof metadata.timezone === "string" && metadata.timezone.trim()
+                ? metadata.timezone.trim()
+                : resolveSystemTimezone();
+            await writeSessionMetadata({
+                projectRoot: this.project_root,
+                agentId: this.agent_id,
+                sessionId: this.session_id,
+                meta: {
+                    ...metadata,
+                    agentId: this.agent_id,
+                    createdAt: created_at,
+                    timezone,
+                },
+            });
+            this.state.createdAt = created_at;
+            this.state.timezone = timezone;
+            this.state.sessionConfig = {
+                ...(metadata.modelLabel
+                    ? { modelLabel: metadata.modelLabel }
+                    : {}),
+            };
+        })();
+        await this.state.initializePromise;
+    }
+    /**
+     * 在执行前确保当前 session 已完成初始化与宿主装配。
+     */
+    async ensure_ready_for_execution() {
+        await this.initialize();
+        if (this.state.ensureConfiguredPromise) {
+            await this.state.ensureConfiguredPromise;
+            return;
+        }
+        this.state.ensureConfiguredPromise = (async () => {
+            if (!this.ensure_configured_hook)
+                return;
+            await this.ensure_configured_hook();
+        })();
+        try {
+            await this.state.ensureConfiguredPromise;
+        }
+        catch (error) {
+            this.state.ensureConfiguredPromise = null;
+            throw error;
+        }
+    }
+    /**
+     * 在 prompt 执行前确保当前 session 已可运行。
+     */
+    async ensure_runnable() {
+        await this.ensure_ready_for_execution();
+        if (!this.state.sessionConfig.model) {
+            throw new Error(`Session "${this.session_id}" requires a configured model. Pass model to new Agent({ model }) or call session.set({ model }) first.`);
+        }
+    }
+    /**
+     * 写入当前 session 配置。
+     */
+    async set(input) {
+        if (input.model) {
+            this.state.sessionConfig.model = normalizeAgentModel(input.model);
+            this.state.sessionConfig.modelLabel = inferAgentModelLabel(input.model);
+            this.executor.clearExecutor();
+        }
+        await patchSessionModelLabel({
+            projectRoot: this.project_root,
+            agentId: this.agent_id,
+            sessionId: this.session_id,
+            model: this.state.sessionConfig.model,
+        });
+    }
+    /**
+     * 追加一条 user 消息并刷新标题与 metadata。
+     */
+    async append_user_message(params) {
+        await this.executor.appendUserMessage(params);
+        await this.ensure_title_from_history({ generate: true });
+        await this.touch_metadata();
+    }
+    /**
+     * 追加一条 assistant 消息并刷新 metadata。
+     */
+    async append_assistant_message(params) {
+        await this.executor.appendAssistantMessage(params);
+        await this.touch_metadata();
+    }
+    /**
+     * 仅刷新当前 session metadata。
+     */
+    async touch_metadata() {
+        await touchSessionMetadata({
+            projectRoot: this.project_root,
+            agentId: this.agent_id,
+            sessionId: this.session_id,
+            sessionConfig: this.state.sessionConfig,
+        });
+    }
+    /**
+     * 确保当前 session 已持久化 title。
+     */
+    async ensure_title_from_history(input) {
+        const messages = await this.history_store.list();
+        const before_metadata = await readSessionMetadata({
+            projectRoot: this.project_root,
+            agentId: this.agent_id,
+            sessionId: this.session_id,
+        });
+        const before_title = String(before_metadata.title || "").trim();
+        const next_metadata = await ensureSessionTitle({
+            projectRoot: this.project_root,
+            agentId: this.agent_id,
+            sessionId: this.session_id,
+            messages,
+            ...(input?.generate ? { model: this.state.sessionConfig.model } : {}),
+            generate: input?.generate === true,
+        });
+        const next_title = String(next_metadata.title || "").trim();
+        if (!next_title || next_title === before_title)
+            return;
+        this.publish_event({
+            type: "session-title",
+            sessionId: this.session_id,
+            title: next_title,
+        });
+    }
+    /**
+     * 持久化最终 assistant 结果。
+     */
+    async persist_assistant_result(assistant_message) {
+        await persistSdkAssistantResult({
+            projectRoot: this.project_root,
+            agentId: this.agent_id,
+            sessionId: this.session_id,
+            sessionConfig: this.state.sessionConfig,
+            executor: this.executor,
+            assistantMessage: assistant_message,
+        });
+    }
+    /**
+     * 构造并持久化一条 prompt user 消息。
+     */
+    async create_and_persist_user_prompt_message(input) {
+        const message = this.history_store.userText({
+            text: String(input.query || "").trim(),
+            metadata: {
+                sessionId: this.session_id,
+            },
+        });
+        await this.executor.appendUserMessage({
+            message,
+        });
+        await this.ensure_title_from_history({ generate: true });
+        await this.touch_metadata();
+        return message;
+    }
+    /**
+     * 持久化本轮执行期间延迟写入的 user 消息。
+     */
+    async persist_deferred_user_messages(deferred_messages) {
+        const normalized_messages = Array.isArray(deferred_messages)
+            ? deferred_messages
+            : [];
+        if (normalized_messages.length <= 0)
+            return;
+        for (const message of normalized_messages) {
+            await this.executor.appendUserMessage({
+                message,
+            });
+        }
+        await this.touch_metadata();
+    }
+}
+//# sourceMappingURL=SessionStateService.js.map

package/bin/session/services/SessionStateService.js.map

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

package/bin/session/services/SessionTurnService.d.ts

@@ -0,0 +1,66 @@
+/**
+ * SessionTurnService：本地 Session turn 编排服务。
+ *
+ * 关键点（中文）
+ * - 统一管理 prompt actor 调度、turn 执行与 Session 事件流派发。
+ * - 该服务负责把 SessionPromptRuntime 与 Executor 连接起来。
+ * - metadata、title、assistant 结果持久化等状态副作用交由 SessionStateService 处理。
+ */
+import type { Executor } from "../../executor/Executor.js";
+import type { AgentSessionEvent } from "../../types/sdk/AgentSessionEvent.js";
+import type { AgentSessionSubscriber, AgentSessionUnsubscribe } from "../../types/sdk/AgentSessionEvent.js";
+import type { AgentSessionPromptInput } from "../../types/sdk/AgentSessionPrompt.js";
+import type { AgentSessionTurnHandle } from "../../types/sdk/AgentSessionTurn.js";
+import { SessionEventHub } from "../../session/runtime/SessionEventHub.js";
+import { SessionStateService } from "../../session/services/SessionStateService.js";
+type SessionTurnServiceOptions = {
+    /**
+     * 当前 session 标识。
+     */
+    session_id: string;
+    /**
+     * 当前 session 执行器。
+     */
+    executor: Executor;
+    /**
+     * 当前 session 状态服务。
+     */
+    state_service: SessionStateService;
+    /**
+     * 当前 session 共享事件总线。
+     */
+    event_hub: SessionEventHub;
+};
+/**
+ * 本地 Session turn 编排服务。
+ */
+export declare class SessionTurnService {
+    private readonly session_id;
+    private readonly executor;
+    private readonly state_service;
+    private readonly event_hub;
+    private readonly prompt_runtime;
+    constructor(options: SessionTurnServiceOptions);
+    /**
+     * 发布一条 session 事件。
+     */
+    publish_event(event: AgentSessionEvent): void;
+    /**
+     * 订阅当前 session 的未来事件。
+     */
+    subscribe(subscriber: AgentSessionSubscriber): AgentSessionUnsubscribe;
+    /**
+     * 判断当前 turn 调度器是否活跃。
+     */
+    is_prompt_runtime_active(): boolean;
+    /**
+     * 追加一条新的 Session prompt。
+     */
+    prompt(input: AgentSessionPromptInput): Promise<AgentSessionTurnHandle>;
+    /**
+     * 执行单轮 prompt turn。
+     */
+    private execute_prompt_turn;
+}
+export {};
+//# sourceMappingURL=SessionTurnService.d.ts.map

package/bin/session/services/SessionTurnService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionTurnService.d.ts","sourceRoot":"","sources":["../../../src/session/services/SessionTurnService.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,KAAK,EACV,sBAAsB,EACtB,uBAAuB,EACxB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AACjF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAM9E,OAAO,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAGvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAC;AAEhF,KAAK,yBAAyB,GAAG;IAC/B;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,QAAQ,EAAE,QAAQ,CAAC;IAEnB;;OAEG;IACH,aAAa,EAAE,mBAAmB,CAAC;IAEnC;;OAEG;IACH,SAAS,EAAE,eAAe,CAAC;CAC5B,CAAC;AAEF;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;IACpC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAsB;IACpD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkB;IAC5C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAuB;gBAE1C,OAAO,EAAE,yBAAyB;IAyB9C;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI;IAI7C;;OAEG;IACH,SAAS,CAAC,UAAU,EAAE,sBAAsB,GAAG,uBAAuB;IAItE;;OAEG;IACH,wBAAwB,IAAI,OAAO;IAInC;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAW7E;;OAEG;YACW,mBAAmB;CA8ElC"}

package/bin/session/services/SessionTurnService.js

@@ -0,0 +1,137 @@
+/**
+ * SessionTurnService：本地 Session turn 编排服务。
+ *
+ * 关键点（中文）
+ * - 统一管理 prompt actor 调度、turn 执行与 Session 事件流派发。
+ * - 该服务负责把 SessionPromptRuntime 与 Executor 连接起来。
+ * - metadata、title、assistant 结果持久化等状态副作用交由 SessionStateService 处理。
+ */
+import { extractTextFromUiMessage } from "../../executor/messages/UIMessageTransformer.js";
+import { mapAgentEventToSessionEvent, mapUiMessageChunkToAgentEvent } from "../../session/SessionEventMapper.js";
+import { SessionPromptRuntime } from "../../session/runtime/SessionPromptRuntime.js";
+/**
+ * 本地 Session turn 编排服务。
+ */
+export class SessionTurnService {
+    session_id;
+    executor;
+    state_service;
+    event_hub;
+    prompt_runtime;
+    constructor(options) {
+        this.session_id = options.session_id;
+        this.executor = options.executor;
+        this.state_service = options.state_service;
+        this.event_hub = options.event_hub;
+        this.prompt_runtime = new SessionPromptRuntime({
+            sessionId: this.session_id,
+            publish: (event) => {
+                this.publish_event(event);
+            },
+            createAndPersistUserMessage: async (input) => {
+                return await this.state_service.create_and_persist_user_prompt_message(input);
+            },
+            executeTurn: async ({ turnId, promptInput, onStepMerge }) => {
+                return await this.execute_prompt_turn({
+                    turnId,
+                    promptInput,
+                    onStepMerge,
+                });
+            },
+        });
+    }
+    /**
+     * 发布一条 session 事件。
+     */
+    publish_event(event) {
+        this.event_hub.publish(event);
+    }
+    /**
+     * 订阅当前 session 的未来事件。
+     */
+    subscribe(subscriber) {
+        return this.event_hub.subscribe(subscriber);
+    }
+    /**
+     * 判断当前 turn 调度器是否活跃。
+     */
+    is_prompt_runtime_active() {
+        return this.prompt_runtime.isActive();
+    }
+    /**
+     * 追加一条新的 Session prompt。
+     */
+    async prompt(input) {
+        const query = String(input.query || "").trim();
+        if (!query) {
+            throw new Error("session.prompt requires a non-empty query");
+        }
+        await this.state_service.ensure_runnable();
+        return await this.prompt_runtime.prompt({
+            query,
+        });
+    }
+    /**
+     * 执行单轮 prompt turn。
+     */
+    async execute_prompt_turn(input) {
+        const tool_name_by_call_id = new Map();
+        const run_context = {
+            sessionId: this.session_id,
+            onStepCallback: input.onStepMerge,
+            onAssistantStepCallback: async (step) => {
+                this.publish_event({
+                    type: "assistant-step",
+                    turnId: input.turnId,
+                    text: step.text,
+                    stepIndex: step.stepIndex,
+                    ...(step.visibility ? { visibility: step.visibility } : {}),
+                });
+            },
+            onUiMessageChunkCallback: async (chunk) => {
+                if (chunk.type === "tool-input-start") {
+                    tool_name_by_call_id.set(chunk.toolCallId, chunk.toolName);
+                    return;
+                }
+                const event = mapUiMessageChunkToAgentEvent(chunk);
+                if (!event)
+                    return;
+                const resolved_event = (event.type === "tool-result" ||
+                    event.type === "tool-error") &&
+                    event.toolName === "unknown"
+                    ? {
+                        ...event,
+                        toolName: tool_name_by_call_id.get(event.toolCallId) || event.toolName,
+                    }
+                    : event;
+                if (resolved_event.type === "tool-call" ||
+                    resolved_event.type === "tool-error") {
+                    tool_name_by_call_id.set(resolved_event.toolCallId, resolved_event.toolName);
+                }
+                const session_event = mapAgentEventToSessionEvent({
+                    event: resolved_event,
+                    turnId: input.turnId,
+                });
+                if (session_event) {
+                    this.publish_event(session_event);
+                }
+            },
+            injectedUserMessages: [],
+            deferredPersistedUserMessages: [],
+            pendingAssistantFileParts: [],
+        };
+        const result = await this.executor.run({
+            query: input.promptInput.query,
+            runContext: run_context,
+        });
+        await this.state_service.persist_assistant_result(result.assistantMessage);
+        await this.state_service.persist_deferred_user_messages(result.deferredPersistedUserMessages);
+        return {
+            text: extractTextFromUiMessage(result.assistantMessage),
+            success: result.success,
+            assistantMessage: result.assistantMessage,
+            ...(result.error ? { error: result.error } : {}),
+        };
+    }
+}
+//# sourceMappingURL=SessionTurnService.js.map

package/bin/session/services/SessionTurnService.js.map

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

package/bin/session/services/SessionViewService.d.ts

@@ -0,0 +1,105 @@
+/**
+ * SessionViewService：本地 Session 查询与派生视图服务。
+ *
+ * 关键点（中文）
+ * - 统一管理 info/history/system/fork 这类读取型能力。
+ * - 该服务只负责拼装查询结果，不负责编排 prompt turn。
+ * - 需要写入持久化状态的地方仍委托给 SessionStateService。
+ */
+import type { JsonlSessionHistoryStore } from "../../executor/store/history/jsonl/JsonlSessionHistoryStore.js";
+import type { SessionSystemComposer } from "../../executor/composer/system/SessionSystemComposer.js";
+import type { AgentSessionForkInput, AgentSessionHistoryInput, AgentSessionHistoryPage, AgentSessionInfo, AgentSessionSystemBlock, AgentSessionSystemSnapshot } from "../../types/agent/AgentTypes.js";
+import { SessionStateService } from "../../session/services/SessionStateService.js";
+type SessionViewServiceOptions<TSession> = {
+    /**
+     * 当前 agent 稳定标识。
+     */
+    agent_id: string;
+    /**
+     * 当前项目根目录。
+     */
+    project_root: string;
+    /**
+     * 当前 session 标识。
+     */
+    session_id: string;
+    /**
+     * 当前 session 历史事实源。
+     */
+    history_store: JsonlSessionHistoryStore;
+    /**
+     * 当前 session 状态服务。
+     */
+    state_service: SessionStateService;
+    /**
+     * 判断当前 session 是否正在执行。
+     */
+    is_executing: () => boolean;
+    /**
+     * 读取 instruction system blocks。
+     */
+    get_instruction_system_blocks: () => AgentSessionSystemBlock[];
+    /**
+     * 读取受托管 plugin system blocks。
+     */
+    get_managed_plugin_system_blocks: () => Promise<AgentSessionSystemBlock[]>;
+    /**
+     * 读取显式注册 plugin system blocks。
+     */
+    get_plugin_system_blocks: () => Promise<AgentSessionSystemBlock[]>;
+    /**
+     * 可选自定义 system composer。
+     *
+     * 关键点（中文）
+     * - 仅当调用方覆盖了 system composer 时传入。
+     * - 默认 SDK system snapshot 仍保留 block 级来源信息。
+     */
+    custom_system_composer?: SessionSystemComposer;
+    /**
+     * 创建一个新的本地 Session 实例。
+     */
+    create_fork_session: (session_id: string) => Promise<{
+        session: TSession;
+        history_store: JsonlSessionHistoryStore;
+        state_service: SessionStateService;
+    }>;
+};
+/**
+ * 本地 Session 查询与派生视图服务。
+ */
+export declare class SessionViewService<TSession> {
+    private readonly agent_id;
+    private readonly project_root;
+    private readonly session_id;
+    private readonly history_store;
+    private readonly state_service;
+    private readonly is_executing;
+    private readonly get_instruction_system_blocks;
+    private readonly get_managed_plugin_system_blocks;
+    private readonly get_plugin_system_blocks;
+    private readonly custom_system_composer?;
+    private readonly create_fork_session;
+    constructor(options: SessionViewServiceOptions<TSession>);
+    /**
+     * 读取当前 session 详情。
+     */
+    get_info(): Promise<AgentSessionInfo>;
+    /**
+     * 读取当前 session 历史分页。
+     */
+    history(input?: AgentSessionHistoryInput): Promise<AgentSessionHistoryPage>;
+    /**
+     * 读取当前 session 生效的 system 快照。
+     */
+    system(): Promise<AgentSessionSystemSnapshot>;
+    private resolve_custom_system_blocks;
+    /**
+     * 从当前 session 创建一个分叉会话。
+     */
+    fork(input?: AgentSessionForkInput | string): Promise<TSession>;
+    private resolve_fork_messages;
+    private append_fork_messages;
+    private stringify_system_content;
+}
+export {};
+//# sourceMappingURL=SessionViewService.d.ts.map

package/bin/session/services/SessionViewService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionViewService.d.ts","sourceRoot":"","sources":["../../../src/session/services/SessionViewService.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAUH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,4DAA4D,CAAC;AAC3G,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qDAAqD,CAAC;AACjG,OAAO,KAAK,EACV,qBAAqB,EACrB,wBAAwB,EACxB,uBAAuB,EACvB,gBAAgB,EAChB,uBAAuB,EACvB,0BAA0B,EAC3B,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAC;AAGhF,KAAK,yBAAyB,CAAC,QAAQ,IAAI;IACzC;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,aAAa,EAAE,wBAAwB,CAAC;IAExC;;OAEG;IACH,aAAa,EAAE,mBAAmB,CAAC;IAEnC;;OAEG;IACH,YAAY,EAAE,MAAM,OAAO,CAAC;IAE5B;;OAEG;IACH,6BAA6B,EAAE,MAAM,uBAAuB,EAAE,CAAC;IAE/D;;OAEG;IACH,gCAAgC,EAAE,MAAM,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAAC;IAE3E;;OAEG;IACH,wBAAwB,EAAE,MAAM,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAAC;IAEnE;;;;;;OAMG;IACH,sBAAsB,CAAC,EAAE,qBAAqB,CAAC;IAE/C;;OAEG;IACH,mBAAmB,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC;QACnD,OAAO,EAAE,QAAQ,CAAC;QAClB,aAAa,EAAE,wBAAwB,CAAC;QACxC,aAAa,EAAE,mBAAmB,CAAC;KACpC,CAAC,CAAC;CACJ,CAAC;AAEF;;GAEG;AACH,qBAAa,kBAAkB,CAAC,QAAQ;IACtC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA2B;IACzD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAsB;IACpD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAsD;IACnF,OAAO,CAAC,QAAQ,CAAC,6BAA6B,CAAuE;IACrH,OAAO,CAAC,QAAQ,CAAC,gCAAgC,CAA0E;IAC3H,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAAkE;IAC3G,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAC,CAAwB;IAChE,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAA6D;gBAErF,OAAO,EAAE,yBAAyB,CAAC,QAAQ,CAAC;IAexD;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,gBAAgB,CAAC;IA2B3C;;OAEG;IACG,OAAO,CACX,KAAK,CAAC,EAAE,wBAAwB,GAC/B,OAAO,CAAC,uBAAuB,CAAC;IAYnC;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,0BAA0B,CAAC;YA0BrC,4BAA4B;IAyB1C;;OAEG;IACG,IAAI,CAAC,KAAK,CAAC,EAAE,qBAAqB,GAAG,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IA6BrE,OAAO,CAAC,qBAAqB;YAef,oBAAoB;IAgBlC,OAAO,CAAC,wBAAwB;CASjC"}