@gracker/smartperfetto 1.0.13

package/dist/agent/scene/sceneTraceDurationProbe.js

@@ -0,0 +1,22 @@
+"use strict";
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (C) 2024-2026 Gracker (Chris)
+// This file is part of SmartPerfetto. See LICENSE for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.probeTraceDuration = probeTraceDuration;
+const PROBE_SQL = 'SELECT (end_ts - start_ts) / 1e9 AS duration_sec FROM trace_bounds';
+async function probeTraceDuration(tps, traceId) {
+    try {
+        const result = await tps.query(traceId, PROBE_SQL);
+        if (!result?.rows?.length)
+            return 0;
+        const raw = result.rows[0][0];
+        const parsed = typeof raw === 'number' ? raw : Number(raw);
+        return Number.isFinite(parsed) && parsed > 0 ? parsed : 0;
+    }
+    catch (err) {
+        console.warn(`[sceneTraceDurationProbe] trace_bounds probe failed for ${traceId}:`, err?.message ?? err);
+        return 0;
+    }
+}
+//# sourceMappingURL=sceneTraceDurationProbe.js.map

package/dist/agent/scene/sceneTraceDurationProbe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sceneTraceDurationProbe.js","sourceRoot":"","sources":["../../../src/agent/scene/sceneTraceDurationProbe.ts"],"names":[],"mappings":";AAAA,6CAA6C;AAC7C,0CAA0C;AAC1C,+DAA+D;;AAqB/D,gDAiBC;AApBD,MAAM,SAAS,GACb,oEAAoE,CAAC;AAEhE,KAAK,UAAU,kBAAkB,CACtC,GAA0B,EAC1B,OAAe;IAEf,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QACnD,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM;YAAE,OAAO,CAAC,CAAC;QACpC,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9B,MAAM,MAAM,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC3D,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5D,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,IAAI,CACV,2DAA2D,OAAO,GAAG,EACpE,GAAa,EAAE,OAAO,IAAI,GAAG,CAC/B,CAAC;QACF,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC"}

package/dist/agent/scene/traceHash.d.ts

@@ -0,0 +1,23 @@
+import type { TraceProcessorService } from '../../services/traceProcessorService';
+/**
+ * Compute the sha256 hex digest of the on-disk trace file.
+ *
+ * Returns `null` when:
+ *  - The trace is external RPC (no file on disk to hash).
+ *  - The file is missing (e.g. trace was deleted between cache check and hash).
+ *  - The stream errors out mid-read.
+ *
+ * Streams the read in chunks so multi-GB traces don't blow up memory.
+ * Tradeoff: hashing 1 GB on a fast SSD takes ~5-10s, so callers must
+ * `await` this off any latency-sensitive code path.
+ */
+export declare function computeTraceContentHash(tps: TraceProcessorService, traceId: string): Promise<string | null>;
+/**
+ * Quick boolean: does this trace have a backing file on disk?
+ *
+ * Used by callers that only need to pick a cache strategy (disk vs memory)
+ * and don't actually need the hash. Cheaper than `computeTraceContentHash`
+ * because it doesn't read the file.
+ */
+export declare function isFileBackedTrace(tps: TraceProcessorService, traceId: string): boolean;
+//# sourceMappingURL=traceHash.d.ts.map

package/dist/agent/scene/traceHash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traceHash.d.ts","sourceRoot":"","sources":["../../../src/agent/scene/traceHash.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAElF;;;;;;;;;;;GAWG;AACH,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,qBAAqB,EAC1B,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAuBxB;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,qBAAqB,EAC1B,OAAO,EAAE,MAAM,GACd,OAAO,CAET"}

package/dist/agent/scene/traceHash.js

@@ -0,0 +1,65 @@
+"use strict";
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (C) 2024-2026 Gracker (Chris)
+// This file is part of SmartPerfetto. See LICENSE for details.
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeTraceContentHash = computeTraceContentHash;
+exports.isFileBackedTrace = isFileBackedTrace;
+/**
+ * traceHash — content addressing for file-backed traces.
+ *
+ * The Scene Story disk cache keys reports by sha256 of the trace file
+ * contents, so reopening the same trace produces the same lookup key
+ * regardless of which `traceId` the upload was assigned. External RPC
+ * traces (registered via TraceProcessorService.registerExternalRpc) have
+ * no file on disk and therefore no content hash — those flow into the
+ * memory cache instead, see `SceneReportMemoryCache`.
+ */
+const crypto_1 = __importDefault(require("crypto"));
+const fs_1 = __importDefault(require("fs"));
+/**
+ * Compute the sha256 hex digest of the on-disk trace file.
+ *
+ * Returns `null` when:
+ *  - The trace is external RPC (no file on disk to hash).
+ *  - The file is missing (e.g. trace was deleted between cache check and hash).
+ *  - The stream errors out mid-read.
+ *
+ * Streams the read in chunks so multi-GB traces don't blow up memory.
+ * Tradeoff: hashing 1 GB on a fast SSD takes ~5-10s, so callers must
+ * `await` this off any latency-sensitive code path.
+ */
+async function computeTraceContentHash(tps, traceId) {
+    const filePath = tps.getTraceFilePath(traceId);
+    // Skip the pre-check `existsSync` — the stream error handler already
+    // covers ENOENT (file deleted between check and open is a classic TOCTOU
+    // race). This saves one syscall per call.
+    return new Promise((resolve) => {
+        const hash = crypto_1.default.createHash('sha256');
+        const stream = fs_1.default.createReadStream(filePath);
+        stream.on('data', (chunk) => hash.update(chunk));
+        stream.on('end', () => resolve(hash.digest('hex')));
+        stream.on('error', (err) => {
+            // ENOENT is expected for external-RPC traces (no file on disk) —
+            // resolve null silently. Other errors get a warning.
+            if (err.code !== 'ENOENT') {
+                console.warn(`[traceHash] Failed to stream-hash trace ${traceId}:`, err?.message ?? err);
+            }
+            resolve(null);
+        });
+    });
+}
+/**
+ * Quick boolean: does this trace have a backing file on disk?
+ *
+ * Used by callers that only need to pick a cache strategy (disk vs memory)
+ * and don't actually need the hash. Cheaper than `computeTraceContentHash`
+ * because it doesn't read the file.
+ */
+function isFileBackedTrace(tps, traceId) {
+    return fs_1.default.existsSync(tps.getTraceFilePath(traceId));
+}
+//# sourceMappingURL=traceHash.js.map

package/dist/agent/scene/traceHash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"traceHash.js","sourceRoot":"","sources":["../../../src/agent/scene/traceHash.ts"],"names":[],"mappings":";AAAA,6CAA6C;AAC7C,0CAA0C;AAC1C,+DAA+D;;;;;AA6B/D,0DA0BC;AASD,8CAKC;AAnED;;;;;;;;;GASG;AAEH,oDAA4B;AAC5B,4CAAoB;AAGpB;;;;;;;;;;;GAWG;AACI,KAAK,UAAU,uBAAuB,CAC3C,GAA0B,EAC1B,OAAe;IAEf,MAAM,QAAQ,GAAG,GAAG,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAE/C,qEAAqE;IACrE,yEAAyE;IACzE,0CAA0C;IAC1C,OAAO,IAAI,OAAO,CAAgB,CAAC,OAAO,EAAE,EAAE;QAC5C,MAAM,IAAI,GAAG,gBAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QACzC,MAAM,MAAM,GAAG,YAAE,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAC7C,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACjD,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACpD,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAA0B,EAAE,EAAE;YAChD,iEAAiE;YACjE,qDAAqD;YACrD,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC1B,OAAO,CAAC,IAAI,CACV,2CAA2C,OAAO,GAAG,EACrD,GAAG,EAAE,OAAO,IAAI,GAAG,CACpB,CAAC;YACJ,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,CAAC;QAChB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,iBAAiB,CAC/B,GAA0B,EAC1B,OAAe;IAEf,OAAO,YAAE,CAAC,UAAU,CAAC,GAAG,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC;AACtD,CAAC"}

package/dist/agent/scene/types.d.ts

@@ -0,0 +1,199 @@
+import type { DataEnvelope } from '../../types/dataContract';
+/**
+ * Scene Story Pipeline — Data Contract Types.
+ *
+ * Two-layer scene model:
+ *  - DisplayedScene: the full scene list shown in the frontend timeline,
+ *    covering every step output from the scene_reconstruction skill
+ *    (app_launches / user_gestures / inertial_scrolls / idle_periods /
+ *     screen_state_changes / scroll_initiation / top_app_changes /
+ *     jank_events fallback).
+ *  - AnalysisInterval: the priority-truncated subset that enters
+ *    SceneAnalysisJobRunner for per-scene Agent analysis.
+ */
+/**
+ * DisplayedScene 的分析状态 — 让前端不需要反查 jobs[] 就能知道某 scene 的分析情况
+ *
+ * 生命周期: not_planned → (queued → running → completed | failed | cancelled | dropped)
+ *
+ * 由 SceneAnalysisJobRunner 在 job 状态变化时同步更新对应 DisplayedScene.analysisState。
+ */
+export type DisplayedSceneAnalysisState = 'not_planned' | 'queued' | 'running' | 'completed' | 'failed' | 'cancelled' | 'dropped';
+/**
+ * 展示用全量场景 — 时间轴上每个用户可感知的动作
+ *
+ * The display layer MUST carry every detected scene (scroll_start /
+ * screen_unlock / idle etc.) so they render on the timeline; the analysis
+ * layer then selects a priority-truncated subset for Agent deep-dive. Merging
+ * the two would silently drop non-problem scene types from the timeline.
+ */
+export interface DisplayedScene {
+    /** Stable id: `${sourceStepId}-${index}` */
+    id: string;
+    /**
+     * Scene category, e.g. 'cold_start' / 'warm_start' / 'hot_start' / 'scroll' /
+     * 'inertial_scroll' / 'scroll_start' / 'tap' / 'long_press' / 'idle' /
+     * 'screen_on' / 'screen_off' / 'screen_unlock' / 'app_switch' / 'navigation' /
+     * 'jank_region'
+     */
+    sceneType: string;
+    /** Source step id from scene_reconstruction.skill.yaml (for provenance) */
+    sourceStepId: string;
+    /** BigInt ns timestamp as string (avoid JS number precision loss) */
+    startTs: string;
+    /** BigInt ns timestamp as string */
+    endTs: string;
+    /** Convenience: (endTs - startTs) / 1_000_000, computed once */
+    durationMs: number;
+    /** App package name or process name, when available */
+    processName?: string;
+    /** Display label e.g. "冷启动 (1240ms)" */
+    label: string;
+    /** Original row fields (for deep-dive parameter building and detail display) */
+    metadata: Record<string, any>;
+    /** Rule-based severity (no LLM): green / yellow / red / unknown */
+    severity: 'good' | 'warning' | 'bad' | 'unknown';
+    /** Analysis lifecycle state — updated by JobRunner as jobs progress */
+    analysisState: DisplayedSceneAnalysisState;
+    /** Set when analysisState !== 'not_planned' */
+    analysisJobId?: string;
+}
+/**
+ * 分析用截断区间 — 由 DisplayedScene 按优先级排序后截断而来
+ * 这是 SceneAnalysisJobRunner 的输入。
+ *
+ * 截断上限遵循现有动态公式:
+ *   max(5, min(20, ceil(traceDurationSec / 10)))
+ */
+export interface AnalysisInterval {
+    /** Links back to DisplayedScene.id */
+    displayedSceneId: string;
+    /** 50/75/90 — higher = more problematic, computed by severity + duration thresholds */
+    priority: number;
+    /** Matched sceneReconstructionRoute id from domainManifest (for audit) */
+    routeRuleId: string;
+    /** Resolved skill id from the matched route */
+    skillId: string;
+    /** Resolved skill params from route.paramMapping applied to DisplayedScene */
+    params: Record<string, any>;
+}
+export type SceneAnalysisJobState = 'queued' | 'running' | 'completed' | 'failed' | 'cancelled' | 'dropped';
+/**
+ * JobRunner 内部 job 状态
+ */
+export interface SceneAnalysisJob {
+    /** `${analysisId}-job-${index}` */
+    jobId: string;
+    analysisId: string;
+    interval: AnalysisInterval;
+    /** 0 = first try, 1 = retry (SCENE_JOB_MAX_RETRIES default) */
+    attempt: number;
+    state: SceneAnalysisJobState;
+    startedAt?: number;
+    endedAt?: number;
+    result?: SceneJobResult;
+    error?: {
+        message: string;
+        stack?: string;
+    };
+}
+/**
+ * 单个 job 的成功产出
+ */
+export interface SceneJobResult {
+    jobId: string;
+    displayedSceneId: string;
+    skillId: string;
+    /** DisplayResult[] from skillEngine — opaque here to avoid circular dep */
+    displayResults: unknown[];
+    /** DataEnvelope[] from skillEngine — opaque here */
+    dataEnvelopes: unknown[];
+    durationMs: number;
+    /** Only set when the skill ran through Claude SDK */
+    costUsd?: number;
+}
+/**
+ * 最终报告 — 持久化到 SceneReportStore,也是 GET /scene-reconstruct/report/:id 的返回
+ *
+ * Cache strategy depends on trace source:
+ *  - file-backed trace → disk store, 7-day TTL (SCENE_REPORT_TTL_MS).
+ *  - external RPC trace → in-memory LRU (SCENE_REPORT_MEMORY_CACHE_MAX).
+ *    No content hash is available for this kind of trace, so the cache is
+ *    process-local and resets on backend restart.
+ */
+export interface SceneReport {
+    /** uuid v4 */
+    reportId: string;
+    tenantId?: string;
+    workspaceId?: string;
+    userId?: string;
+    /** sha256 of trace file content; null for external RPC (no content access) */
+    traceHash: string | null;
+    /** Backend ephemeral trace id */
+    traceId: string;
+    /** Determines cache strategy */
+    traceOrigin: 'file' | 'external_rpc';
+    /** 'disk_7d' for file-backed, 'memory_session' for external RPC */
+    cachePolicy: 'disk_7d' | 'memory_session';
+    /** null for memory_session (expires on process restart) */
+    expiresAt: number | null;
+    createdAt: number;
+    /** Trace metadata snapshot */
+    traceMeta: {
+        device?: string;
+        app?: string;
+        durationSec: number;
+        androidVersion?: string;
+        capturedAt?: number;
+    };
+    /** Full scene list, including scenes not selected for analysis */
+    displayedScenes: DisplayedScene[];
+    /**
+     * Stage1 DataEnvelopes captured verbatim so cache-hit replays can
+     * recreate the same lane overlays the cold-path emits via `data` SSE
+     * events.
+     */
+    cachedDataEnvelopes: DataEnvelope[];
+    /** Analysis jobs, one per AnalysisInterval (may include cancelled/failed states) */
+    jobs: SceneAnalysisJob[];
+    /**
+     * Cross-scene narrative produced by the Stage3 summary pass.
+     * null when Stage3 is skipped (e.g. cancelled before all jobs terminate)
+     * or errors; callers must handle null rather than assume a string.
+     */
+    summary: string | null;
+    /** Cross-scene structured insights (optional, empty array if Stage3 skipped) */
+    insights: SceneInsight[];
+    /** true if cancelled or has any failed jobs */
+    partialReport: boolean;
+    totalDurationMs: number;
+    totalCostUsd?: number;
+    generatedBy: {
+        runtime: 'claude-sdk' | 'legacy';
+        model?: string;
+        pipelineVersion: 'v2';
+    };
+}
+/**
+ * 跨场景洞察 — Stage3 产出 (可选)
+ */
+export interface SceneInsight {
+    /** Short title, e.g. "冷启动 JIT 影响了首屏滑动" */
+    title: string;
+    /** Markdown body */
+    body: string;
+    /** DisplayedScene.id references */
+    relatedDisplayedSceneIds: string[];
+}
+/**
+ * Scene Story pipeline SSE event types.
+ *
+ * Prefix convention: `scene_story_` strictly distinguishes these events
+ * from the legacy `scene_detected` / `track_data` names so that
+ * singular-vs-plural event-listener collisions cannot happen.
+ *
+ * Emitted directly via broadcastToAgentDrivenClients — these do NOT pass
+ * through claudeSseBridge, which is reserved for SDK message translation.
+ */
+export type SceneStreamEventType = 'scene_story_detected' | 'scene_story_queued' | 'scene_story_started' | 'scene_story_retrying' | 'scene_story_completed' | 'scene_story_failed' | 'scene_story_cancelled' | 'scene_story_dropped' | 'scene_story_report_ready';
+//# sourceMappingURL=types.d.ts.map

package/dist/agent/scene/types.d.ts.map

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

package/dist/agent/scene/types.js

@@ -0,0 +1,6 @@
+"use strict";
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (C) 2024-2026 Gracker (Chris)
+// This file is part of SmartPerfetto. See LICENSE for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/agent/scene/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/agent/scene/types.ts"],"names":[],"mappings":";AAAA,6CAA6C;AAC7C,0CAA0C;AAC1C,+DAA+D"}

package/dist/agent/state/checkpointManager.d.ts

@@ -0,0 +1,85 @@
+import { Checkpoint, StageResult, Finding, AgentPhase, SerializedAgentState } from '../types';
+export interface CheckpointManagerConfig {
+    checkpointDir?: string;
+    retentionMs?: number;
+    maxCheckpointsPerSession?: number;
+}
+/**
+ * 检查点管理器实现
+ */
+export declare class CheckpointManager {
+    private config;
+    private checkpointDir;
+    constructor(config?: CheckpointManagerConfig);
+    /**
+     * 创建检查点
+     */
+    createCheckpoint(sessionId: string, stageId: string, phase: AgentPhase, stageResults: StageResult[], findings: Finding[], additionalState?: Partial<SerializedAgentState>): Promise<Checkpoint>;
+    /**
+     * 保存检查点到磁盘
+     */
+    private saveCheckpoint;
+    /**
+     * 生成检查点 ID
+     */
+    private generateCheckpointId;
+    /**
+     * 加载检查点
+     */
+    loadCheckpoint(sessionId: string, checkpointId: string): Promise<Checkpoint | null>;
+    /**
+     * 获取会话的最新检查点
+     */
+    getLatestCheckpoint(sessionId: string): Promise<Checkpoint | null>;
+    /**
+     * 列出会话的所有检查点
+     */
+    listCheckpoints(sessionId: string): Promise<Checkpoint[]>;
+    /**
+     * 获取检查点对应的阶段结果
+     */
+    getStageResults(sessionId: string, checkpointId: string): Promise<StageResult[]>;
+    /**
+     * 清理旧检查点（保留最新的 N 个）
+     */
+    private cleanupOldCheckpoints;
+    /**
+     * 删除检查点
+     */
+    deleteCheckpoint(sessionId: string, checkpointId: string): Promise<void>;
+    /**
+     * 清理会话的所有检查点
+     */
+    clearSession(sessionId: string): Promise<void>;
+    /**
+     * 清理过期检查点
+     */
+    cleanupExpired(): Promise<number>;
+    /**
+     * 获取会话目录路径
+     */
+    private getSessionDir;
+    /**
+     * 确保目录存在
+     */
+    private ensureDirectory;
+    /**
+     * 检查会话是否有可恢复的检查点
+     */
+    canResume(sessionId: string): Promise<boolean>;
+    /**
+     * 获取可恢复的会话列表
+     */
+    listRecoverableSessions(): Promise<string[]>;
+    /**
+     * 获取检查点统计信息
+     */
+    getStats(): Promise<{
+        totalSessions: number;
+        totalCheckpoints: number;
+        oldestCheckpoint: number | null;
+        newestCheckpoint: number | null;
+    }>;
+}
+export default CheckpointManager;
+//# sourceMappingURL=checkpointManager.d.ts.map

package/dist/agent/state/checkpointManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpointManager.d.ts","sourceRoot":"","sources":["../../../src/agent/state/checkpointManager.ts"],"names":[],"mappings":"AAeA,OAAO,EACL,UAAU,EACV,WAAW,EACX,OAAO,EACP,UAAU,EACV,oBAAoB,EAIrB,MAAM,UAAU,CAAC;AAQlB,MAAM,WAAW,uBAAuB;IACtC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wBAAwB,CAAC,EAAE,MAAM,CAAC;CACnC;AAED;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAoC;IAClD,OAAO,CAAC,aAAa,CAAS;gBAElB,MAAM,GAAE,uBAA4B;IAchD;;OAEG;IACG,gBAAgB,CACpB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,UAAU,EACjB,YAAY,EAAE,WAAW,EAAE,EAC3B,QAAQ,EAAE,OAAO,EAAE,EACnB,eAAe,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAC9C,OAAO,CAAC,UAAU,CAAC;IA+BtB;;OAEG;YACW,cAAc;IAQ5B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAQ5B;;OAEG;IACG,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAezF;;OAEG;IACG,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAYxE;;OAEG;IACG,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IA0B/D;;OAEG;IACG,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAStF;;OAEG;YACW,qBAAqB;IAiBnC;;OAEG;IACG,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAa9E;;OAEG;IACG,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYpD;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IAoCvC;;OAEG;IACH,OAAO,CAAC,aAAa;IAIrB;;OAEG;IACH,OAAO,CAAC,eAAe;IAOvB;;OAEG;IACG,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKpD;;OAEG;IACG,uBAAuB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAqBlD;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC;QACxB,aAAa,EAAE,MAAM,CAAC;QACtB,gBAAgB,EAAE,MAAM,CAAC;QACzB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;QAChC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;KACjC,CAAC;CAoCH;AAED,eAAe,iBAAiB,CAAC"}