@zhin.js/agent 0.0.0

package/lib/cron-engine.d.ts

@@ -0,0 +1,91 @@
+/**
+ * 持久化定时任务
+ *
+ * 将定时任务持久化到 data/cron-jobs.json，进程重启后自动加载；
+ * 触发时以 prompt 调用 ZhinAgent，实现「到点执行 AI 任务」。
+ *
+ * - 存储：id, cronExpression, prompt, label?, enabled, createdAt
+ * - 启动时：读取文件 → 为每条启用的任务创建 Cron → 注册到 CronFeature
+ * - CLI / AI 工具：可对持久化任务做 list / add / remove / pause / resume（AI 侧立即生效）
+ */
+import { Cron, ZhinTool } from '@zhin.js/core';
+export declare const CRON_JOBS_FILENAME = "cron-jobs.json";
+export interface CronJobRecord {
+    id: string;
+    /** Cron 表达式，5 字段：分 时 日 月 周 */
+    cronExpression: string;
+    /** 触发时发给 AI 的 prompt */
+    prompt: string;
+    /** 可选标签，便于识别 */
+    label?: string;
+    /** 是否启用（暂停的任务不加载） */
+    enabled: boolean;
+    createdAt: number;
+}
+export declare function getCronJobsFilePath(dataDir: string): string;
+export declare function readCronJobsFile(dataDir: string): Promise<CronJobRecord[]>;
+export declare function writeCronJobsFile(dataDir: string, jobs: CronJobRecord[]): Promise<void>;
+export type CronRunner = (prompt: string, jobId: string) => void | Promise<void>;
+export type AddCronFn = (cron: Cron) => () => void;
+export interface PersistentCronEngineOptions {
+    dataDir: string;
+    addCron: AddCronFn;
+    runner: CronRunner;
+}
+export declare class PersistentCronEngine {
+    private options;
+    /** jobId -> dispose */
+    private disposes;
+    constructor(options: PersistentCronEngineOptions);
+    getDataDir(): string;
+    /**
+     * 从文件加载任务并注册到 CronFeature；仅加载 enabled 的任务。
+     */
+    load(): void;
+    private registerOne;
+    /**
+     * 列出所有持久化任务（从文件读取）
+     */
+    listJobs(): Promise<CronJobRecord[]>;
+    /**
+     * 添加持久化任务并立即生效
+     */
+    addJob(record: Omit<CronJobRecord, 'createdAt'> & {
+        createdAt?: number;
+    }): Promise<CronJobRecord>;
+    /**
+     * 删除持久化任务并立即生效
+     */
+    removeJob(id: string): Promise<boolean>;
+    /**
+     * 暂停任务（不删除，停止调度）
+     */
+    pauseJob(id: string): Promise<boolean>;
+    /**
+     * 恢复已暂停的任务
+     */
+    resumeJob(id: string): Promise<boolean>;
+    /**
+     * 卸载所有由本引擎注册的定时任务（用于 dispose）
+     */
+    unload(): void;
+}
+/**
+ * 生成唯一 ID（用于 CLI / AI 添加时）
+ */
+export declare function generateCronJobId(): string;
+export interface CronManager {
+    cronFeature: {
+        getStatus(): Array<{
+            expression: string;
+            running: boolean;
+            nextExecution: Date | null;
+            plugin: string;
+        }>;
+    };
+    engine: PersistentCronEngine | null;
+}
+export declare function setCronManager(m: CronManager | null): void;
+export declare function getCronManager(): CronManager | null;
+export declare function createCronTools(): ZhinTool[];
+//# sourceMappingURL=cron-engine.d.ts.map

package/lib/cron-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron-engine.d.ts","sourceRoot":"","sources":["../src/cron-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAS/C,eAAO,MAAM,kBAAkB,mBAAmB,CAAC;AAEnD,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,8BAA8B;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,wBAAwB;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qBAAqB;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAYhF;AAED,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAI7F;AAMD,MAAM,MAAM,UAAU,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAEjF,MAAM,MAAM,SAAS,GAAG,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,IAAI,CAAC;AAEnD,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,SAAS,CAAC;IACnB,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,OAAO,CAA8B;IAC7C,uBAAuB;IACvB,OAAO,CAAC,QAAQ,CAAiC;gBAErC,OAAO,EAAE,2BAA2B;IAIhD,UAAU,IAAI,MAAM;IAIpB;;OAEG;IACH,IAAI,IAAI,IAAI;IAeZ,OAAO,CAAC,WAAW;IAkBnB;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAI1C;;OAEG;IACG,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,WAAW,CAAC,GAAG;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,aAAa,CAAC;IAevG;;OAEG;IACG,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAa7C;;OAEG;IACG,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAc5C;;OAEG;IACG,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAU7C;;OAEG;IACH,MAAM,IAAI,IAAI;CAQf;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAMD,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE;QAAE,SAAS,IAAI,KAAK,CAAC;YAAE,UAAU,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,OAAO,CAAC;YAAC,aAAa,EAAE,IAAI,GAAG,IAAI,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;IAC1H,MAAM,EAAE,oBAAoB,GAAG,IAAI,CAAC;CACrC;AAID,wBAAgB,cAAc,CAAC,CAAC,EAAE,WAAW,GAAG,IAAI,GAAG,IAAI,CAE1D;AAED,wBAAgB,cAAc,IAAI,WAAW,GAAG,IAAI,CAEnD;AAMD,wBAAgB,eAAe,IAAI,QAAQ,EAAE,CAiG5C"}

package/lib/cron-engine.js

@@ -0,0 +1,277 @@
+/**
+ * 持久化定时任务
+ *
+ * 将定时任务持久化到 data/cron-jobs.json，进程重启后自动加载；
+ * 触发时以 prompt 调用 ZhinAgent，实现「到点执行 AI 任务」。
+ *
+ * - 存储：id, cronExpression, prompt, label?, enabled, createdAt
+ * - 启动时：读取文件 → 为每条启用的任务创建 Cron → 注册到 CronFeature
+ * - CLI / AI 工具：可对持久化任务做 list / add / remove / pause / resume（AI 侧立即生效）
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { Cron, ZhinTool } from '@zhin.js/core';
+import { Logger } from '@zhin.js/logger';
+const logger = new Logger(null, 'cron-engine');
+// ─────────────────────────────────────────────────────────────────────────────
+// 类型与存储路径
+// ─────────────────────────────────────────────────────────────────────────────
+export const CRON_JOBS_FILENAME = 'cron-jobs.json';
+export function getCronJobsFilePath(dataDir) {
+    return path.join(dataDir, CRON_JOBS_FILENAME);
+}
+export async function readCronJobsFile(dataDir) {
+    const filePath = getCronJobsFilePath(dataDir);
+    try {
+        const raw = await fs.promises.readFile(filePath, 'utf-8');
+        const data = JSON.parse(raw);
+        if (!Array.isArray(data))
+            return [];
+        return data;
+    }
+    catch (e) {
+        if (e?.code === 'ENOENT')
+            return [];
+        logger.warn('读取定时任务文件失败: ' + (e?.message || String(e)));
+        return [];
+    }
+}
+export async function writeCronJobsFile(dataDir, jobs) {
+    const filePath = getCronJobsFilePath(dataDir);
+    await fs.promises.mkdir(path.dirname(filePath), { recursive: true });
+    await fs.promises.writeFile(filePath, JSON.stringify(jobs, null, 2), 'utf-8');
+}
+export class PersistentCronEngine {
+    options;
+    /** jobId -> dispose */
+    disposes = new Map();
+    constructor(options) {
+        this.options = options;
+    }
+    getDataDir() {
+        return this.options.dataDir;
+    }
+    /**
+     * 从文件加载任务并注册到 CronFeature；仅加载 enabled 的任务。
+     */
+    load() {
+        const { dataDir, addCron, runner } = this.options;
+        readCronJobsFile(dataDir).then((jobs) => {
+            for (const job of jobs) {
+                if (!job.enabled)
+                    continue;
+                this.registerOne(job, addCron, runner);
+            }
+            if (jobs.filter((j) => j.enabled).length > 0) {
+                logger.info(`已加载 ${this.disposes.size} 个持久化定时任务`);
+            }
+        }).catch((e) => {
+            logger.warn('加载持久化定时任务失败: ' + (e?.message || String(e)));
+        });
+    }
+    registerOne(job, addCron, runner) {
+        const { prompt, id: jobId, cronExpression } = job;
+        try {
+            const cron = new Cron(cronExpression, async () => {
+                await runner(prompt, jobId);
+            });
+            cron.id = jobId;
+            const dispose = addCron(cron);
+            this.disposes.set(jobId, dispose);
+        }
+        catch (e) {
+            logger.warn(`定时任务加载失败 [${jobId}]: ${e?.message || String(e)}`);
+        }
+    }
+    /**
+     * 列出所有持久化任务（从文件读取）
+     */
+    async listJobs() {
+        return readCronJobsFile(this.options.dataDir);
+    }
+    /**
+     * 添加持久化任务并立即生效
+     */
+    async addJob(record) {
+        const jobs = await readCronJobsFile(this.options.dataDir);
+        const full = {
+            ...record,
+            createdAt: record.createdAt ?? Date.now(),
+            enabled: record.enabled ?? true,
+        };
+        jobs.push(full);
+        await writeCronJobsFile(this.options.dataDir, jobs);
+        if (full.enabled) {
+            this.registerOne(full, this.options.addCron, this.options.runner);
+        }
+        return full;
+    }
+    /**
+     * 删除持久化任务并立即生效
+     */
+    async removeJob(id) {
+        const jobs = await readCronJobsFile(this.options.dataDir);
+        const next = jobs.filter((j) => j.id !== id);
+        if (next.length === jobs.length)
+            return false;
+        await writeCronJobsFile(this.options.dataDir, next);
+        const dispose = this.disposes.get(id);
+        if (dispose) {
+            dispose();
+            this.disposes.delete(id);
+        }
+        return true;
+    }
+    /**
+     * 暂停任务（不删除，停止调度）
+     */
+    async pauseJob(id) {
+        const jobs = await readCronJobsFile(this.options.dataDir);
+        const j = jobs.find((x) => x.id === id);
+        if (!j)
+            return false;
+        j.enabled = false;
+        await writeCronJobsFile(this.options.dataDir, jobs);
+        const dispose = this.disposes.get(id);
+        if (dispose) {
+            dispose();
+            this.disposes.delete(id);
+        }
+        return true;
+    }
+    /**
+     * 恢复已暂停的任务
+     */
+    async resumeJob(id) {
+        const jobs = await readCronJobsFile(this.options.dataDir);
+        const j = jobs.find((x) => x.id === id);
+        if (!j)
+            return false;
+        j.enabled = true;
+        await writeCronJobsFile(this.options.dataDir, jobs);
+        this.registerOne(j, this.options.addCron, this.options.runner);
+        return true;
+    }
+    /**
+     * 卸载所有由本引擎注册的定时任务（用于 dispose）
+     */
+    unload() {
+        for (const dispose of this.disposes.values()) {
+            try {
+                dispose();
+            }
+            catch (_) { }
+        }
+        this.disposes.clear();
+    }
+}
+/**
+ * 生成唯一 ID（用于 CLI / AI 添加时）
+ */
+export function generateCronJobId() {
+    return `cron_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 8)}`;
+}
+let cronManager = null;
+export function setCronManager(m) {
+    cronManager = m;
+}
+export function getCronManager() {
+    return cronManager;
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// AI 可调用的定时任务管理工具
+// ─────────────────────────────────────────────────────────────────────────────
+export function createCronTools() {
+    const listTool = new ZhinTool('cron_list')
+        .desc('列出所有定时任务：包括插件注册的内存任务与持久化任务（持久化任务有 id，可用于 cron_remove/cron_pause/cron_resume）')
+        .keyword('定时任务', 'cron', '计划任务', '任务列表')
+        .tag('cron', 'schedule')
+        .execute(async () => {
+        const m = getCronManager();
+        if (!m) {
+            return { error: '定时任务服务不可用' };
+        }
+        const memory = m.cronFeature.getStatus().map((s) => ({
+            type: 'memory',
+            expression: s.expression,
+            running: s.running,
+            nextExecution: s.nextExecution?.toISOString() ?? null,
+            plugin: s.plugin,
+        }));
+        const persistent = m.engine
+            ? (await m.engine.listJobs()).map((j) => ({
+                type: 'persistent',
+                id: j.id,
+                cronExpression: j.cronExpression,
+                prompt: j.prompt,
+                label: j.label,
+                enabled: j.enabled,
+                createdAt: j.createdAt,
+            }))
+            : [];
+        return { memory, persistent };
+    });
+    const addTool = new ZhinTool('cron_add')
+        .desc('添加一条持久化定时任务：到点由 AI 执行指定 prompt，重启后仍保留')
+        .keyword('添加定时', '新建定时任务', 'cron add')
+        .tag('cron', 'schedule')
+        .param('cron_expression', { type: 'string', description: 'Cron 表达式，如 "0 9 * * *" 表示每天 9:00' }, true)
+        .param('prompt', { type: 'string', description: '到点触发时发给 AI 的提示词' }, true)
+        .param('label', { type: 'string', description: '可选标签，便于识别' })
+        .execute(async (args) => {
+        const m = getCronManager();
+        if (!m?.engine) {
+            return { error: '持久化定时任务引擎不可用' };
+        }
+        const id = generateCronJobId();
+        const job = await m.engine.addJob({
+            id,
+            cronExpression: args.cron_expression,
+            prompt: args.prompt,
+            label: args.label,
+            enabled: true,
+        });
+        return { success: true, id: job.id, message: '已添加并立即生效' };
+    });
+    const removeTool = new ZhinTool('cron_remove')
+        .desc('按 id 删除一条持久化定时任务')
+        .keyword('删除定时', '取消定时', 'cron remove')
+        .tag('cron', 'schedule')
+        .param('id', { type: 'string', description: '任务 ID（cron_list 中 persistent 的 id）' }, true)
+        .execute(async (args) => {
+        const m = getCronManager();
+        if (!m?.engine) {
+            return { error: '持久化定时任务引擎不可用' };
+        }
+        const ok = await m.engine.removeJob(args.id);
+        return ok ? { success: true, message: '已删除' } : { error: '未找到该任务' };
+    });
+    const pauseTool = new ZhinTool('cron_pause')
+        .desc('暂停一条持久化定时任务（不删除，可 cron_resume 恢复）')
+        .keyword('暂停定时', 'cron pause')
+        .tag('cron', 'schedule')
+        .param('id', { type: 'string', description: '任务 ID' }, true)
+        .execute(async (args) => {
+        const m = getCronManager();
+        if (!m?.engine) {
+            return { error: '持久化定时任务引擎不可用' };
+        }
+        const ok = await m.engine.pauseJob(args.id);
+        return ok ? { success: true, message: '已暂停' } : { error: '未找到该任务' };
+    });
+    const resumeTool = new ZhinTool('cron_resume')
+        .desc('恢复已暂停的持久化定时任务')
+        .keyword('恢复定时', 'cron resume')
+        .tag('cron', 'schedule')
+        .param('id', { type: 'string', description: '任务 ID' }, true)
+        .execute(async (args) => {
+        const m = getCronManager();
+        if (!m?.engine) {
+            return { error: '持久化定时任务引擎不可用' };
+        }
+        const ok = await m.engine.resumeJob(args.id);
+        return ok ? { success: true, message: '已恢复' } : { error: '未找到该任务' };
+    });
+    return [listTool, addTool, removeTool, pauseTool, resumeTool];
+}
+//# sourceMappingURL=cron-engine.js.map

package/lib/cron-engine.js.map

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

package/lib/follow-up.d.ts

@@ -0,0 +1,131 @@
+/**
+ * FollowUpStore — 定时跟进任务的持久化存储
+ *
+ * 解决纯 setTimeout 重启即丢失的问题：
+ *   1. 创建任务时同步写入数据库
+ *   2. 执行完成 / 过期后从数据库中删除
+ *   3. 机器人启动时从数据库加载所有未完成任务，重新挂定时器
+ *   4. 同一会话创建新任务时，自动取消旧的 pending 任务（防止重复提醒）
+ *
+ *   ai_followups 表：
+ *   ┌──────────────────────────────────────────────────────────────────┐
+ *   │ id (PK)  | session_id | platform | sender_id | scene_id        │
+ *   │          | message    | fire_at  | created_at | status          │
+ *   └──────────────────────────────────────────────────────────────────┘
+ */
+export declare const AI_FOLLOWUP_MODEL: {
+    session_id: {
+        type: "text";
+        nullable: boolean;
+    };
+    platform: {
+        type: "text";
+        nullable: boolean;
+    };
+    bot_id: {
+        type: "text";
+        nullable: boolean;
+    };
+    sender_id: {
+        type: "text";
+        nullable: boolean;
+    };
+    scene_id: {
+        type: "text";
+        nullable: boolean;
+    };
+    scene_type: {
+        type: "text";
+        nullable: boolean;
+    };
+    message: {
+        type: "text";
+        nullable: boolean;
+    };
+    /** 触发时间戳 (ms) */
+    fire_at: {
+        type: "integer";
+        nullable: boolean;
+    };
+    created_at: {
+        type: "integer";
+        default: number;
+    };
+    /** pending | fired | cancelled */
+    status: {
+        type: "text";
+        default: string;
+    };
+};
+export interface FollowUpRecord {
+    id?: number;
+    session_id: string;
+    platform: string;
+    bot_id: string;
+    sender_id: string;
+    scene_id: string;
+    scene_type: string;
+    message: string;
+    fire_at: number;
+    created_at: number;
+    status: string;
+}
+/**
+ * 数据库模型接口（与 RelatedModel 的链式查询 API 对齐）
+ */
+interface DbModel {
+    select(...fields: string[]): any;
+    create(data: Record<string, any>): Promise<any>;
+    update(data: Partial<any>): any;
+    delete(condition: Record<string, any>): any;
+}
+/**
+ * 发送提醒的回调函数
+ *
+ * 由 ZhinAgent 在 init 阶段注入，负责把提醒消息发到正确的会话。
+ */
+export type FollowUpSender = (record: FollowUpRecord) => Promise<void>;
+export declare class FollowUpManager {
+    private store;
+    /** 内存中活跃的定时器: recordId → timer */
+    private timers;
+    private sender;
+    constructor();
+    /** 注入消息发送回调 */
+    setSender(sender: FollowUpSender): void;
+    /** 升级到数据库存储 */
+    upgradeToDatabase(model: DbModel): void;
+    /**
+     * 创建一个跟进任务
+     *
+     * 重要：同一会话的旧 pending 任务会被自动取消，防止重复提醒。
+     *
+     * @returns 人类可读的确认文本
+     */
+    schedule(params: {
+        sessionId: string;
+        platform: string;
+        botId: string;
+        senderId: string;
+        sceneId: string;
+        sceneType: string;
+        message: string;
+        delayMinutes: number;
+    }): Promise<string>;
+    /**
+     * 取消指定会话的所有 pending 任务
+     */
+    cancelBySession(sessionId: string): Promise<number>;
+    /**
+     * 启动时从数据库恢复所有未完成的跟进任务
+     */
+    restore(): Promise<number>;
+    /**
+     * 为一条记录挂定时器
+     */
+    private scheduleTimer;
+    private scheduleTimerWithDelay;
+    dispose(): void;
+}
+export {};
+//# sourceMappingURL=follow-up.d.ts.map

package/lib/follow-up.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"follow-up.d.ts","sourceRoot":"","sources":["../src/follow-up.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAUH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAQ5B,iBAAiB;;;;;;;;;IAGjB,kCAAkC;;;;;CAEnC,CAAC;AAMF,MAAM,WAAW,cAAc;IAC7B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,UAAU,OAAO;IACf,MAAM,CAAC,GAAG,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC;IACjC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAChD,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;IAChC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,CAAC;CAC7C;AAED;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAuFvE,qBAAa,eAAe;IAC1B,OAAO,CAAC,KAAK,CAAiB;IAC9B,kCAAkC;IAClC,OAAO,CAAC,MAAM,CAAyD;IACvE,OAAO,CAAC,MAAM,CAA+B;;IAM7C,eAAe;IACf,SAAS,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI;IAIvC,eAAe;IACf,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAOvC;;;;;;OAMG;IACG,QAAQ,CAAC,MAAM,EAAE;QACrB,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,YAAY,EAAE,MAAM,CAAC;KACtB,GAAG,OAAO,CAAC,MAAM,CAAC;IA4DnB;;OAEG;IACG,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAoBzD;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;IA4BhC;;OAEG;IACH,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,sBAAsB;IA6B9B,OAAO,IAAI,IAAI;CAOhB"}