@downcity/agent 1.1.408 → 1.1.437

package/bin/session/SessionTitle.d.ts

@@ -2,21 +2,22 @@
  * SDK Session 标题生成与持久化辅助。
  *
  * 关键点（中文）
- * - session title 是 `meta.json` 顶层字段，列表与详情都以它为准。
+ * - session title 是 `session_state` 的字段，列表与详情都以它为准。
  * - title 默认允许为空；只有模型成功生成标题时才会写入。
  * - 当 title 仍为空时，后续执行链路可以再次尝试生成。
  */
 import type { ModelClient } from "@downcity/type";
-import type { SessionHistoryMetaV1 } from "../executor/types/SessionHistoryMeta.js";
+import type { SessionHistoryMeta } from "../executor/types/SessionHistoryMeta.js";
 import type { Logger } from "../utils/logger/Logger.js";
-import type { SessionDataStore } from "../types/store/SessionDataStore.js";
-import type { SessionMessage } from "../types/session/SessionMessage.js";
+import type { SessionStorage } from "../types/store/SessionStorage.js";
+import type { SessionMessage } from "@downcity/type";
+import type { ModelRequestFailureReporter } from "../types/executor/ModelRequest.js";
 /**
  * 标题持久化参数。
  */
 export interface EnsureSessionTitleParams {
     /** 当前 Session 的领域持久化入口。 */
-    store: SessionDataStore;
+    store: SessionStorage;
     /**
      * 当前 session_id。
      */
@@ -43,11 +44,40 @@ export interface EnsureSessionTitleParams {
     generate?: boolean;
     /** 可选的标题请求取消信号。 */
     signal?: AbortSignal;
+    /** 可选的模型请求逐次失败通知入口。 */
+    on_model_request_failure?: ModelRequestFailureReporter;
     /** 可选的标题提交入口，用于与其他 metadata mutation 串行化。 */
-    commit_title?: (title: string) => Promise<SessionHistoryMetaV1>;
+    commit_title?: (title: string) => Promise<SessionHistoryMeta>;
 }
+/** 根据首条用户消息生成规范化后的会话标题。 */
+export declare function generate_session_title(input: {
+    /**
+     * 当前模型实例。
+     */
+    model: ModelClient;
+    /**
+     * 当前 session 标识。
+     */
+    session_id: string;
+    /**
+     * 当前模型展示标签；仅用于排障日志。
+     */
+    model_label?: string;
+    /**
+     * 首条用户消息文本。
+     */
+    first_user_text: string;
+    /**
+     * 当前 session 运行日志器。
+     */
+    logger?: Logger;
+    /** 标题请求取消信号。 */
+    signal?: AbortSignal;
+    /** 可选的模型请求逐次失败通知入口。 */
+    on_model_request_failure?: ModelRequestFailureReporter;
+}): Promise<string | undefined>;
 /**
  * 确保当前 session meta 中持久化 title。
  */
-export declare function ensure_session_title(input: EnsureSessionTitleParams): Promise<SessionHistoryMetaV1>;
+export declare function ensure_session_title(input: EnsureSessionTitleParams): Promise<SessionHistoryMeta>;
 //# sourceMappingURL=SessionTitle.d.ts.map

package/bin/session/SessionTitle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SessionTitle.d.ts","sourceRoot":"","sources":["../../src/session/SessionTitle.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAKlD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AACnF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAEvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAKxE;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,2BAA2B;IAC3B,KAAK,EAAE,gBAAgB,CAAC;IAExB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,QAAQ,EAAE,cAAc,EAAE,CAAC;IAE3B;;OAEG;IACH,KAAK,CAAC,EAAE,WAAW,CAAC;IAEpB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,mBAAmB;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;IAErB,6CAA6C;IAC7C,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,oBAAoB,CAAC,CAAC;CACjE;AA6KD;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,wBAAwB,GAC9B,OAAO,CAAC,oBAAoB,CAAC,CAwC/B"}
+{"version":3,"file":"SessionTitle.d.ts","sourceRoot":"","sources":["../../src/session/SessionTitle.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAKlD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AACjF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAEvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAIpF;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,2BAA2B;IAC3B,KAAK,EAAE,cAAc,CAAC;IAEtB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,QAAQ,EAAE,cAAc,EAAE,CAAC;IAE3B;;OAEG;IACH,KAAK,CAAC,EAAE,WAAW,CAAC;IAEpB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,mBAAmB;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;IAErB,uBAAuB;IACvB,wBAAwB,CAAC,EAAE,2BAA2B,CAAC;IAEvD,6CAA6C;IAC7C,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAC/D;AAkGD,2BAA2B;AAC3B,wBAAsB,sBAAsB,CAAC,KAAK,EAAE;IAClD;;OAEG;IACH,KAAK,EAAE,WAAW,CAAC;IAEnB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,eAAe,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,gBAAgB;IAChB,MAAM,CAAC,EAAE,WAAW,CAAC;IAErB,uBAAuB;IACvB,wBAAwB,CAAC,EAAE,2BAA2B,CAAC;CACxD,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAiD9B;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,wBAAwB,GAC9B,OAAO,CAAC,kBAAkB,CAAC,CAyC7B"}

package/bin/session/SessionTitle.js

@@ -2,25 +2,25 @@
  * SDK Session 标题生成与持久化辅助。
  *
  * 关键点（中文）
- * - session title 是 `meta.json` 顶层字段，列表与详情都以它为准。
+ * - session title 是 `session_state` 的字段，列表与详情都以它为准。
  * - title 默认允许为空；只有模型成功生成标题时才会写入。
  * - 当 title 仍为空时，后续执行链路可以再次尝试生成。
  */
 import { build_text_model_messages, generate_model, } from "../executor/model/ModelGenerate.js";
-import { normalize_session_title } from "./storage/Metadata.js";
-import { extract_session_message_text } from "./messages/SessionMessageText.js";
+import { normalize_session_title } from "../session/storage/Metadata.js";
+import { extract_session_message_text } from "../session/messages/SessionMessageText.js";
 const GENERATED_SESSION_TITLE_MAX_CHARS = 24;
-function truncateTitle(input, maxChars) {
+function truncate_title(input, max_chars) {
     const title = String(input || "").replace(/\s+/g, " ").trim();
     if (!title)
         return "";
-    if (title.length <= maxChars)
+    if (title.length <= max_chars)
         return title;
-    return title.slice(0, maxChars).trimEnd();
+    return title.slice(0, max_chars).trimEnd();
 }
-function resolveFirstUserText(messages) {
+function resolve_first_user_text(messages) {
     for (const message of messages) {
-        if (message.type !== "user")
+        if (message.role !== "user")
             continue;
         const text = extract_session_message_text(message);
         if (text)
@@ -28,20 +28,20 @@ function resolveFirstUserText(messages) {
     }
     return "";
 }
-function normalizeGeneratedTitle(input) {
-    const firstLine = String(input || "")
+function normalize_generated_title(input) {
+    const first_line = String(input || "")
         .split("\n")
         .map((line) => line.trim())
         .find(Boolean);
-    const title = normalize_session_title(String(firstLine || "")
+    const title = normalize_session_title(String(first_line || "")
         .replace(/^["'`“”‘’]+|["'`“”‘’]+$/g, "")
         .replace(/^标题[:：]\s*/i, "")
         .trim());
     return title
-        ? truncateTitle(title, GENERATED_SESSION_TITLE_MAX_CHARS)
+        ? truncate_title(title, GENERATED_SESSION_TITLE_MAX_CHARS)
         : undefined;
 }
-function summarizeTitleError(error) {
+function summarize_title_error(error) {
     const record = error && typeof error === "object" && !Array.isArray(error)
         ? error
         : {};
@@ -51,7 +51,7 @@ function summarizeTitleError(error) {
         error: String(error),
     };
 }
-async function logSessionTitleDiagnostic(input) {
+async function log_session_title_diagnostic(input) {
     if (!input.logger)
         return;
     try {
@@ -64,44 +64,49 @@ async function logSessionTitleDiagnostic(input) {
         // 关键点（中文）：标题诊断日志失败不能影响 session 主流程。
     }
 }
-async function generateSessionTitle(input) {
+/** 根据首条用户消息生成规范化后的会话标题。 */
+export async function generate_session_title(input) {
     try {
         const result = await generate_model(input.model, {
             messages: build_text_model_messages("You generate minimal conversation titles. Output only the title itself, with no explanation and no quotation marks.", [
                 "Generate a short conversation title from the first user message below.",
                 "Requirements: 3 to 12 Chinese characters or 2 to 6 English words; no period; no prefix.",
                 "",
-                input.firstUserText,
+                input.first_user_text,
             ].join("\n")),
-        }, input.signal);
+        }, {
+            request_kind: "session_title",
+            signal: input.signal,
+            on_failure: input.on_model_request_failure,
+        });
         const text = result.text;
-        const generatedTitle = normalizeGeneratedTitle(text);
-        if (!generatedTitle) {
-            await logSessionTitleDiagnostic({
+        const generated_title = normalize_generated_title(text);
+        if (!generated_title) {
+            await log_session_title_diagnostic({
                 logger: input.logger,
                 session_id: input.session_id,
                 level: "warn",
                 message: "[agent] session_title.empty",
                 details: {
                     model_label: input.model_label || null,
-                    firstUserTextLength: input.firstUserText.length,
+                    firstUserTextLength: input.first_user_text.length,
                     rawTitleLength: String(text || "").length,
                 },
             });
         }
-        return generatedTitle;
+        return generated_title;
     }
     catch (error) {
-        const effectiveError = error;
-        await logSessionTitleDiagnostic({
+        const effective_error = error;
+        await log_session_title_diagnostic({
             logger: input.logger,
             session_id: input.session_id,
             level: "warn",
             message: "[agent] session_title.generate_failed",
             details: {
                 model_label: input.model_label || null,
-                firstUserTextLength: input.firstUserText.length,
-                ...summarizeTitleError(effectiveError),
+                firstUserTextLength: input.first_user_text.length,
+                ...summarize_title_error(effective_error),
             },
         });
         // 关键点（中文）：标题生成失败不能影响 session 主流程。
@@ -115,12 +120,12 @@ export async function ensure_session_title(input) {
     const current = await input.store.read_metadata();
     if (current.title)
         return current;
-    const firstUserText = resolveFirstUserText(input.messages);
+    const first_user_text = resolve_first_user_text(input.messages);
     if (input.generate !== true) {
         return current;
     }
-    if (!input.model || !firstUserText) {
-        await logSessionTitleDiagnostic({
+    if (!input.model || !first_user_text) {
+        await log_session_title_diagnostic({
             logger: input.logger,
             session_id: input.session_id,
             level: "debug",
@@ -133,23 +138,24 @@ export async function ensure_session_title(input) {
         });
         return current;
     }
-    const generatedTitle = await generateSessionTitle({
+    const generated_title = await generate_session_title({
         model: input.model,
         session_id: input.session_id,
         model_label: input.model_label,
-        firstUserText,
+        first_user_text,
         logger: input.logger,
         signal: input.signal,
+        on_model_request_failure: input.on_model_request_failure,
     });
-    if (!generatedTitle)
+    if (!generated_title)
         return current;
     if (input.commit_title)
-        return await input.commit_title(generatedTitle);
-    const generatedMeta = {
+        return await input.commit_title(generated_title);
+    const generated_meta = {
         ...(await input.store.read_metadata()),
-        title: generatedTitle,
+        title: generated_title,
     };
-    await input.store.write_metadata(generatedMeta);
-    return generatedMeta;
+    await input.store.write_metadata(generated_meta);
+    return generated_meta;
 }
 //# sourceMappingURL=SessionTitle.js.map

package/bin/session/SessionTitle.js.map

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

package/bin/session/browse/Browse.d.ts

@@ -1,71 +1,57 @@
 /**
- * SDK Session 浏览辅助。
+ * Session 浏览投影。
  *
- * 关键点（中文）
- * - 统一负责 session 列表摘要、session 详情与 history 分页的投影逻辑。
- * - session title 允许为空；浏览层不会再从首条 user message 推导 fallback title。
- * - 面向 SDK / RemoteAgent / downcity gateway route 复用，避免在多个入口重复拼列表与分页语义。
- * - 这里不持有运行态状态；执行状态等动态信息通过调用参数显式注入。
+ * 本模块只从每个 Session 的 `session.db` 读取列表所需的轻量状态；Message 正文仍由
+ * SessionStorage 聚合读取。浏览逻辑不创建 schema，也不尝试迁移旧文件格式。
  */
 import type { AgentListSessionsInput, AgentSessionInfo, AgentSessionSummaryPage } from "../../types/agent/SessionTypes.js";
-import type { SessionHistoryMetaV1 } from "../../executor/types/SessionHistoryMeta.js";
-import type { SessionMessage } from "../../types/session/SessionMessage.js";
-import type { FileSystem } from "@downcity/workspace";
-type SessionBrowseBaseInput = {
-    /**
-     * 当前项目根目录。
-     */
+import type { SessionHistoryMeta } from "../../executor/types/SessionHistoryMeta.js";
+import { type FileSystem, type SessionMessage } from "@downcity/type";
+/** Session 详情投影输入。 */
+interface SessionBrowseBaseInput {
+    /** 当前项目或私有存储根目录。 */
     project_root: string;
-    /**
-     * 当前 agent_id。
-     */
+    /** 当前 Agent 标识。 */
     agent_id: string;
-    /**
-     * 当前 session_id。
-     */
+    /** 当前 Session 标识。 */
     session_id: string;
-    /**
-     * 当前 session 已读取到的 metadata。
-     */
-    metadata: SessionHistoryMetaV1;
-    /**
-     * 当前 session 已读取到的完整消息。
-     *
-     * 说明（中文）：列表查询已有 metadata 摘要时可省略，详情查询仍传完整记录。
-     */
+    /** 已读取的 Session 状态。 */
+    metadata: SessionHistoryMeta;
+    /** 可选完整 Message，用于即时生成详情预览。 */
     messages?: SessionMessage[];
-    /**
-     * 当前 session 是否正在执行。
-     */
+    /** 当前 Session 是否正在执行。 */
     executing?: boolean;
-};
-/**
- * 读取指定 JSONL 消息文件。
- */
-export declare function load_session_messages_from_path(filePath: string, files: FileSystem): Promise<SessionMessage[]>;
-/**
- * 基于 metadata + messages 构建 SDK session 详情。
- */
+}
+/** 基于 metadata 与可选 Message 构建 SDK Session 详情。 */
 export declare function build_session_info(input: SessionBrowseBaseInput): AgentSessionInfo;
-/**
- * 列出指定 agent 的 session 摘要页。
- */
-export declare function list_agent_session_summary_page(params: {
+/** 只读打开一个现有数据库并读取 Session 状态；失败时不改写磁盘。 */
+export declare function read_session_metadata_from_database(database_path: string, fallback_origin_type: string): SessionHistoryMeta | null;
+/** 列出活动 Session 摘要页。 */
+export declare function list_agent_session_summary_page(input: {
+    /** Agent 私有存储根目录。 */
     project_root: string;
+    /** 当前 Agent 标识。 */
     agent_id: string;
+    /** 可选 Workspace 过滤。 */
     workspace_id?: string;
+    /** 列表查询。 */
     input?: AgentListSessionsInput;
-    executingSessionIds?: Set<string>;
+    /** 当前执行中的 Session。 */
+    executing_session_ids?: ReadonlySet<string>;
+    /** Agent 私有文件能力。 */
     files: FileSystem;
 }): Promise<AgentSessionSummaryPage>;
-/**
- * 列出指定 agent 的已归档 session 摘要页。
- */
-export declare function list_archived_agent_session_summary_page(params: {
+/** 列出归档 Session 摘要页。 */
+export declare function list_archived_agent_session_summary_page(input: {
+    /** Agent 私有存储根目录。 */
     project_root: string;
+    /** 当前 Agent 标识。 */
     agent_id: string;
+    /** 可选 Workspace 过滤。 */
     workspace_id?: string;
+    /** 列表查询。 */
     input?: AgentListSessionsInput;
+    /** Agent 私有文件能力。 */
     files: FileSystem;
 }): Promise<AgentSessionSummaryPage>;
 export {};

package/bin/session/browse/Browse.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Browse.d.ts","sourceRoot":"","sources":["../../../src/session/browse/Browse.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EACV,sBAAsB,EACtB,gBAAgB,EAEhB,uBAAuB,EACxB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AAWnF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,KAAK,sBAAsB,GAAG;IAC5B;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,QAAQ,EAAE,oBAAoB,CAAC;IAE/B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAC;IAE5B;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC;AAyCF;;GAEG;AACH,wBAAsB,+BAA+B,CACnD,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,UAAU,GAChB,OAAO,CAAC,cAAc,EAAE,CAAC,CAmC3B;AA6BD;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,sBAAsB,GAC5B,gBAAgB,CAsClB;AA8HD;;GAEG;AACH,wBAAsB,+BAA+B,CAAC,MAAM,EAAE;IAC5D,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,sBAAsB,CAAC;IAC/B,mBAAmB,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAClC,KAAK,EAAE,UAAU,CAAC;CACnB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CA0FnC;AAED;;GAEG;AACH,wBAAsB,wCAAwC,CAAC,MAAM,EAAE;IACrE,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,sBAAsB,CAAC;IAC/B,KAAK,EAAE,UAAU,CAAC;CACnB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAyFnC"}
+{"version":3,"file":"Browse.d.ts","sourceRoot":"","sources":["../../../src/session/browse/Browse.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EACV,sBAAsB,EACtB,gBAAgB,EAEhB,uBAAuB,EACxB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAQjF,OAAO,EAGL,KAAK,UAAU,EACf,KAAK,cAAc,EACpB,MAAM,gBAAgB,CAAC;AA8BxB,sBAAsB;AACtB,UAAU,sBAAsB;IAC9B,oBAAoB;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,qBAAqB;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,uBAAuB;IACvB,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAC;IAC5B,yBAAyB;IACzB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAoCD,iDAAiD;AACjD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,sBAAsB,GAAG,gBAAgB,CAuBlF;AAED,0CAA0C;AAC1C,wBAAgB,mCAAmC,CACjD,aAAa,EAAE,MAAM,EACrB,oBAAoB,EAAE,MAAM,GAC3B,kBAAkB,GAAG,IAAI,CA+B3B;AAED,wBAAwB;AACxB,wBAAsB,+BAA+B,CAAC,KAAK,EAAE;IAC3D,qBAAqB;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,uBAAuB;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY;IACZ,KAAK,CAAC,EAAE,sBAAsB,CAAC;IAC/B,sBAAsB;IACtB,qBAAqB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC5C,oBAAoB;IACpB,KAAK,EAAE,UAAU,CAAC;CACnB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAEnC;AAED,wBAAwB;AACxB,wBAAsB,wCAAwC,CAAC,KAAK,EAAE;IACpE,qBAAqB;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,uBAAuB;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY;IACZ,KAAK,CAAC,EAAE,sBAAsB,CAAC;IAC/B,oBAAoB;IACpB,KAAK,EAAE,UAAU,CAAC;CACnB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAEnC"}