lightclawbot 1.0.0 → 1.0.2

package/dist/src/history/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * LightClaw — History Module
+ *
+ * 统一导出历史消息处理的全部公开 API。
+ *
+ * 模块结构：
+ *   types.ts           — 类型定义
+ *   session-store.ts    — session 索引加载 & 路径解析
+ *   text-processing.ts  — 传输元数据剥离 & 文件附件提取
+ *   message-parser.ts   — JSONL 消息行解析 & 标准化
+ *   cron-utils.ts       — cron session key 解析 & cron 消息清理
+ *   session-reader.ts   — 核心读取 API（含混合读取）
+ */
+export type { FileAttachmentInfo, CronInfo, HistoryMessage, SessionStoreEntry, SessionType, CronSessionInfo, SessionListEntry, ReadHistoryOptions, ReadHistoryWithCronOptions, ReadHistoryTailOptions, ContentEntry, } from "./types.js";
+export { resolveOpenClawHome, resolveSessionsDir, loadSessionStore, resolveTranscriptPath, getStoreDir, } from "./session-store.js";
+export { stripTransportMetadata, stripResidualMetadata, extractFileAttachments, deduplicateFiles, } from "./text-processing.js";
+export { isSystemInjectedUserMessage, extractText, extractRawText, extractThinking, extractToolCalls, extractContentFiles, normalizeMessage, } from "./message-parser.js";
+export { isCronSessionKey, isCronRunKey, isCronBaseKey, extractCronJobId, extractCronRunId, classifySessionKey, listCronSessions, groupCronSessionsByJob, extractCronInfoFromText, cleanCronUserMessage, extractCronJobIdsFromTranscript, findCronSessionsByJobIds, } from "./cron-utils.js";
+export { readSessionHistory, readSessionHistoryTail, readCronHistory, readSessionHistoryWithCron, listSessions, } from "./session-reader.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/history/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/history/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,YAAY,EACV,kBAAkB,EAClB,QAAQ,EACR,cAAc,EACd,iBAAiB,EACjB,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,0BAA0B,EAC1B,sBAAsB,EACtB,YAAY,GACb,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,qBAAqB,EACrB,WAAW,GACZ,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,2BAA2B,EAC3B,WAAW,EACX,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,sBAAsB,EACtB,uBAAuB,EACvB,oBAAoB,EACpB,+BAA+B,EAC/B,wBAAwB,GACzB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,eAAe,EACf,0BAA0B,EAC1B,YAAY,GACb,MAAM,qBAAqB,CAAC"}

package/dist/src/history/index.js

@@ -0,0 +1,24 @@
+/**
+ * LightClaw — History Module
+ *
+ * 统一导出历史消息处理的全部公开 API。
+ *
+ * 模块结构：
+ *   types.ts           — 类型定义
+ *   session-store.ts    — session 索引加载 & 路径解析
+ *   text-processing.ts  — 传输元数据剥离 & 文件附件提取
+ *   message-parser.ts   — JSONL 消息行解析 & 标准化
+ *   cron-utils.ts       — cron session key 解析 & cron 消息清理
+ *   session-reader.ts   — 核心读取 API（含混合读取）
+ */
+// ── Session Store ──
+export { resolveOpenClawHome, resolveSessionsDir, loadSessionStore, resolveTranscriptPath, getStoreDir, } from "./session-store.js";
+// ── Text Processing ──
+export { stripTransportMetadata, stripResidualMetadata, extractFileAttachments, deduplicateFiles, } from "./text-processing.js";
+// ── Message Parser ──
+export { isSystemInjectedUserMessage, extractText, extractRawText, extractThinking, extractToolCalls, extractContentFiles, normalizeMessage, } from "./message-parser.js";
+// ── Cron Utilities ──
+export { isCronSessionKey, isCronRunKey, isCronBaseKey, extractCronJobId, extractCronRunId, classifySessionKey, listCronSessions, groupCronSessionsByJob, extractCronInfoFromText, cleanCronUserMessage, extractCronJobIdsFromTranscript, findCronSessionsByJobIds, } from "./cron-utils.js";
+// ── Session Reader (核心 API) ──
+export { readSessionHistory, readSessionHistoryTail, readCronHistory, readSessionHistoryWithCron, listSessions, } from "./session-reader.js";
+//# sourceMappingURL=index.js.map

package/dist/src/history/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/history/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAiBH,sBAAsB;AACtB,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,qBAAqB,EACrB,WAAW,GACZ,MAAM,oBAAoB,CAAC;AAE5B,wBAAwB;AACxB,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAE9B,uBAAuB;AACvB,OAAO,EACL,2BAA2B,EAC3B,WAAW,EACX,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAE7B,uBAAuB;AACvB,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,sBAAsB,EACtB,uBAAuB,EACvB,oBAAoB,EACpB,+BAA+B,EAC/B,wBAAwB,GACzB,MAAM,iBAAiB,CAAC;AAEzB,gCAAgC;AAChC,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,eAAe,EACf,0BAA0B,EAC1B,YAAY,GACb,MAAM,qBAAqB,CAAC"}

package/dist/src/history/message-parser.d.ts

@@ -0,0 +1,52 @@
+/**
+ * LightClaw — Message Parser
+ *
+ * 封装 JSONL session transcript 中消息行的解析和标准化逻辑。
+ * 包含：
+ *   - 文本提取（含传输层元数据剥离）
+ *   - thinking 内容提取
+ *   - 工具调用/结果提取
+ *   - 文件附件提取
+ *   - 系统注入消息检测
+ *   - 消息标准化
+ */
+import type { FileAttachmentInfo, HistoryMessage } from "./types.js";
+/**
+ * 检测 role=user 的消息是否实际上是传输层/系统注入的消息，而非用户真实输入。
+ *
+ * 匹配 "System: [timestamp]" 格式的消息（包括 cron 定时提醒触发的注入消息）。
+ * 这些消息本质上都是系统自动生成的指令文本，不是用户手动输入，
+ * 用户只需看到 assistant 的回复即可。
+ */
+export declare function isSystemInjectedUserMessage(msg: Record<string, unknown>): boolean;
+/**
+ * 从 content 字段提取纯文本（用户消息会剥离传输元数据）
+ */
+export declare function extractText(content: unknown, role?: string): string;
+/**
+ * 从 content 字段提取原始文本（不做剥离，用于文件信息提取）
+ */
+export declare function extractRawText(content: unknown): string;
+/**
+ * 从 content 字段提取 thinking 内容
+ */
+export declare function extractThinking(content: unknown): string | undefined;
+/**
+ * 从 content 字段提取工具调用信息
+ *
+ * 兼容 type: "tool_use" / "tool_call" / "toolCall"
+ * 兼容参数字段: input / arguments / args
+ */
+export declare function extractToolCalls(content: unknown): Array<{
+    name: string;
+    args?: string;
+}> | undefined;
+/**
+ * 从 content 字段提取文件/图片信息
+ */
+export declare function extractContentFiles(content: unknown): FileAttachmentInfo[] | undefined;
+/**
+ * 将原始 JSONL message 对象标准化为 HistoryMessage
+ */
+export declare function normalizeMessage(msg: Record<string, unknown>): HistoryMessage | null;
+//# sourceMappingURL=message-parser.d.ts.map

package/dist/src/history/message-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-parser.d.ts","sourceRoot":"","sources":["../../../src/history/message-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAgB,kBAAkB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAiBnF;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAUjF;AAwBD;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAkBnE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAcvD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAapE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,SAAS,CAqBrG;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,kBAAkB,EAAE,GAAG,SAAS,CAiBtF;AAWD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,cAAc,GAAG,IAAI,CA6DpF"}

package/dist/src/history/message-parser.js

@@ -0,0 +1,243 @@
+/**
+ * LightClaw — Message Parser
+ *
+ * 封装 JSONL session transcript 中消息行的解析和标准化逻辑。
+ * 包含：
+ *   - 文本提取（含传输层元数据剥离）
+ *   - thinking 内容提取
+ *   - 工具调用/结果提取
+ *   - 文件附件提取
+ *   - 系统注入消息检测
+ *   - 消息标准化
+ */
+import { stripTransportMetadata, extractFileAttachments, deduplicateFiles, } from "./text-processing.js";
+// ============================================================
+// 系统注入消息检测
+// ============================================================
+/**
+ * 匹配 "System: [<timestamp>]" 格式的消息前缀。
+ * 如定时提醒回调：System: [2026-03-05 16:23:00 GMT+8] ⏰ 提醒：该看日志啦！
+ */
+const SYSTEM_INJECTED_RE = /^System:\s*\[\d{4}-\d{2}-\d{2}\s+\d{2}:\d{2}/;
+/**
+ * 检测 role=user 的消息是否实际上是传输层/系统注入的消息，而非用户真实输入。
+ *
+ * 匹配 "System: [timestamp]" 格式的消息（包括 cron 定时提醒触发的注入消息）。
+ * 这些消息本质上都是系统自动生成的指令文本，不是用户手动输入，
+ * 用户只需看到 assistant 的回复即可。
+ */
+export function isSystemInjectedUserMessage(msg) {
+    if (msg.role?.toLowerCase() !== "user")
+        return false;
+    const text = extractFirstText(msg.content);
+    if (!text)
+        return false;
+    const trimmed = text.trim();
+    // 所有 "System: [timestamp]" 格式的消息都是系统注入的，包括定时提醒触发消息
+    return SYSTEM_INJECTED_RE.test(trimmed);
+}
+/**
+ * 提取消息内容中的第一个文本片段（用于系统注入检测）
+ */
+function extractFirstText(content) {
+    if (typeof content === "string")
+        return content;
+    if (!Array.isArray(content))
+        return undefined;
+    for (const entry of content) {
+        if (!entry || typeof entry !== "object")
+            continue;
+        if ((entry.type === "text" || entry.type === "input_text")
+            && typeof entry.text === "string") {
+            return entry.text;
+        }
+    }
+    return undefined;
+}
+// ============================================================
+// 内容提取
+// ============================================================
+/**
+ * 从 content 字段提取纯文本（用户消息会剥离传输元数据）
+ */
+export function extractText(content, role) {
+    if (typeof content === "string") {
+        return role === "user" ? stripTransportMetadata(content) : content;
+    }
+    if (!Array.isArray(content))
+        return "";
+    const parts = [];
+    for (const entry of content) {
+        if (!entry || typeof entry !== "object")
+            continue;
+        if ((entry.type === "text" || entry.type === "output_text" || entry.type === "input_text")
+            && typeof entry.text === "string") {
+            parts.push(entry.text);
+        }
+    }
+    const joined = parts.join("\n");
+    return role === "user" ? stripTransportMetadata(joined) : joined;
+}
+/**
+ * 从 content 字段提取原始文本（不做剥离，用于文件信息提取）
+ */
+export function extractRawText(content) {
+    if (typeof content === "string")
+        return content;
+    if (!Array.isArray(content))
+        return "";
+    const parts = [];
+    for (const entry of content) {
+        if (!entry || typeof entry !== "object")
+            continue;
+        if ((entry.type === "text" || entry.type === "output_text" || entry.type === "input_text")
+            && typeof entry.text === "string") {
+            parts.push(entry.text);
+        }
+    }
+    return parts.join("\n");
+}
+/**
+ * 从 content 字段提取 thinking 内容
+ */
+export function extractThinking(content) {
+    if (!Array.isArray(content))
+        return undefined;
+    const parts = [];
+    for (const entry of content) {
+        if (!entry || typeof entry !== "object")
+            continue;
+        if (entry.type === "thinking") {
+            const text = typeof entry.thinking === "string"
+                ? entry.thinking
+                : typeof entry.text === "string" ? entry.text : undefined;
+            if (text)
+                parts.push(text);
+        }
+    }
+    return parts.length > 0 ? parts.join("\n") : undefined;
+}
+/**
+ * 从 content 字段提取工具调用信息
+ *
+ * 兼容 type: "tool_use" / "tool_call" / "toolCall"
+ * 兼容参数字段: input / arguments / args
+ */
+export function extractToolCalls(content) {
+    if (!Array.isArray(content))
+        return undefined;
+    const calls = [];
+    for (const entry of content) {
+        if (!entry || typeof entry !== "object")
+            continue;
+        if (entry.type === "tool_use" || entry.type === "tool_call" || entry.type === "toolCall") {
+            const name = typeof entry.name === "string"
+                ? entry.name
+                : typeof entry.toolName === "string"
+                    ? entry.toolName
+                    : typeof entry.tool_name === "string"
+                        ? entry.tool_name
+                        : "unknown";
+            const rawArgs = entry.input ?? entry.arguments ?? entry.args;
+            const args = rawArgs
+                ? (typeof rawArgs === "string" ? rawArgs : JSON.stringify(rawArgs))
+                : undefined;
+            calls.push({ name, args });
+        }
+    }
+    return calls.length > 0 ? calls : undefined;
+}
+/**
+ * 从 content 字段提取文件/图片信息
+ */
+export function extractContentFiles(content) {
+    if (!Array.isArray(content))
+        return undefined;
+    const files = [];
+    for (const entry of content) {
+        if (!entry || typeof entry !== "object")
+            continue;
+        if (entry.type === "image" || entry.type === "file") {
+            // 跳过只有 data 字段的内嵌 base64 图片
+            if (entry.type === "image" && entry.data && !entry.uri && !entry.fileName && !entry.file_name && !entry.filename) {
+                continue;
+            }
+            const name = asString(entry.fileName) ?? asString(entry.file_name) ?? asString(entry.filename) ?? asString(entry.name) ?? (entry.type === "image" ? "image" : "file");
+            const mimeType = asString(entry.mimeType) ?? asString(entry.mime_type);
+            const uri = asString(entry.uri);
+            files.push({ name, mimeType, uri });
+        }
+    }
+    return files.length > 0 ? files : undefined;
+}
+/** 安全提取非空字符串 */
+function asString(v) {
+    return typeof v === "string" && v.trim() ? v : undefined;
+}
+// ============================================================
+// 消息标准化
+// ============================================================
+/**
+ * 将原始 JSONL message 对象标准化为 HistoryMessage
+ */
+export function normalizeMessage(msg) {
+    const role = msg.role;
+    if (!role)
+        return null;
+    const normalizedRole = (() => {
+        switch (role.toLowerCase()) {
+            case "user": return "user";
+            case "assistant": return "assistant";
+            case "system": return "system";
+            case "tool":
+            case "toolresult":
+            case "tool_result":
+                return "tool";
+            default: return "assistant";
+        }
+    })();
+    const text = extractText(msg.content, normalizedRole);
+    const toolCalls = normalizedRole === "assistant" ? extractToolCalls(msg.content) : undefined;
+    const thinking = normalizedRole === "assistant" ? extractThinking(msg.content) : undefined;
+    const timestamp = typeof msg.timestamp === "number" ? msg.timestamp : undefined;
+    // 从用户消息文本中提取文件附件
+    let files;
+    if (normalizedRole === "user") {
+        const rawText = extractRawText(msg.content);
+        const textFiles = extractFileAttachments(rawText);
+        const contentFiles = extractContentFiles(msg.content);
+        const allFiles = [...(textFiles.length > 0 ? textFiles : []), ...(contentFiles ?? [])];
+        if (allFiles.length > 0)
+            files = deduplicateFiles(allFiles);
+    }
+    else {
+        files = extractContentFiles(msg.content) || undefined;
+    }
+    // tool / toolResult 角色的处理
+    let toolResult;
+    if (normalizedRole === "tool") {
+        const toolCallId = asString(msg.toolCallId)
+            ?? asString(msg.tool_call_id)
+            ?? asString(msg.callId);
+        const name = asString(msg.name)
+            ?? asString(msg.toolName)
+            ?? asString(msg.tool_name);
+        const output = text
+            || (msg.result ? (typeof msg.result === "string" ? msg.result : JSON.stringify(msg.result)) : undefined)
+            || undefined;
+        toolResult = { toolCallId, name, output };
+    }
+    // 跳过完全空的消息
+    if (!text && !toolCalls && !toolResult && !thinking && !files?.length)
+        return null;
+    return {
+        role: normalizedRole,
+        content: text,
+        timestamp,
+        ...(toolCalls && { toolCalls }),
+        ...(toolResult && { toolResult }),
+        ...(thinking && { thinking }),
+        ...(files && files.length > 0 && { files }),
+    };
+}
+//# sourceMappingURL=message-parser.js.map

package/dist/src/history/message-parser.js.map

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

package/dist/src/history/session-reader.d.ts

@@ -0,0 +1,58 @@
+/**
+ * LightClaw — Session Reader
+ *
+ * 核心的历史消息读取逻辑，包含：
+ *   - readSessionHistory()          — 读取单个 session 的历史消息
+ *   - readSessionHistoryTail()      — 从文件末尾高效读取（大文件优化）
+ *   - readCronHistory()             — 读取指定 cron job 的全部运行历史
+ *   - readSessionHistoryWithCron()  — 【方案C核心】主会话 + cron 消息按时间线混合
+ *   - listSessions()                — 列出所有 session（含 cron 类型标识）
+ */
+import type { HistoryMessage, ReadHistoryOptions, ReadHistoryTailOptions, ReadHistoryWithCronOptions, SessionListEntry } from "./types.js";
+/**
+ * 读取指定 sessionKey 的历史对话消息
+ *
+ * @param sessionKey - 会话标识（与 gateway.ts 中 route.sessionKey 一致）
+ * @param opts - 选项
+ * @returns 历史消息数组（按时间正序），如果找不到 session 返回空数组
+ */
+export declare function readSessionHistory(sessionKey: string, opts?: ReadHistoryOptions): HistoryMessage[];
+/**
+ * 读取指定 sessionKey 的历史消息（从文件末尾读取，大文件性能更好）
+ *
+ * 对于大文件（>maxBytes），不读取整个文件，而是从末尾读取指定字节数。
+ */
+export declare function readSessionHistoryTail(sessionKey: string, opts?: ReadHistoryTailOptions): HistoryMessage[];
+/**
+ * 读取指定 cron job 的所有运行历史（跨多个 run session）
+ *
+ * @param cronJobId - cron job UUID
+ * @param opts - 选项
+ * @returns 按时间正序排列的所有运行消息（仅 user + assistant）
+ */
+export declare function readCronHistory(cronJobId: string, opts?: ReadHistoryOptions): HistoryMessage[];
+/**
+ * 读取主会话历史 + 关联的 cron 消息，按时间线合并
+ *
+ * 关联机制（精确关联，非遍历全量）：
+ *   1. 读取主会话 JSONL → 解析消息 + 同时扫描 cron 工具调用结果
+ *   2. 从 cron toolResult 中提取 cron job IDs（显式关联）
+ *   3. 用这些 job IDs 到 sessions.json 中精确匹配 cron run sessions
+ *   4. 读取关联的 cron run sessions 的消息
+ *   5. 按时间窗口过滤 + 合并排序
+ *
+ * 相比旧方案（遍历所有 cron sessions + 时间窗口近似匹配），
+ * 新方案通过主会话中的 cron 工具调用记录建立了**显式关联关系**。
+ *
+ * @param sessionKey - 主会话标识
+ * @param opts - 选项（可控制是否包含 cron、筛选特定 cron job）
+ * @returns 按时间正序排列的合并消息
+ */
+export declare function readSessionHistoryWithCron(sessionKey: string, opts?: ReadHistoryWithCronOptions): HistoryMessage[];
+/**
+ * 列出所有已知的 session（从 sessions.json 索引读取）
+ *
+ * 增强：每个条目标识会话类型（direct / cron-base / cron-run）
+ */
+export declare function listSessions(agentId?: string): SessionListEntry[];
+//# sourceMappingURL=session-reader.d.ts.map

package/dist/src/history/session-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-reader.d.ts","sourceRoot":"","sources":["../../../src/history/session-reader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EACV,cAAc,EACd,kBAAkB,EAClB,sBAAsB,EACtB,0BAA0B,EAC1B,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAgBpB;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,kBAAkB,GAAG,cAAc,EAAE,CAalG;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE,sBAAsB,GAC5B,cAAc,EAAE,CA6ClB;AAMD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE,kBAAkB,GACxB,cAAc,EAAE,CA4BlB;AAMD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE,0BAA0B,GAChC,cAAc,EAAE,CAiElB;AAMD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAejE"}