@ai-studio-3d/vyasa 0.1.0

package/dist/core/index/tail.js

@@ -0,0 +1,123 @@
+import { EventEmitter } from 'node:events';
+import { statSync } from 'node:fs';
+import chokidar from 'chokidar';
+import { parseJsonl } from '../jsonl/index.js';
+import { parseCodex } from '../codex/index.js';
+import { ingestFromParsed } from './ingest.js';
+import { prepareIngestStatements } from './statements.js';
+import { loadPricingMap } from './pricing-map.js';
+import { indexProgress } from './progress.js';
+// Claude/Codex flush several JSONL lines per turn (one fsync each). 300ms
+// covers the burst so we re-ingest once per turn, not once per line.
+const DEBOUNCE_MS = 300;
+/**
+ * Watches `~/.claude/projects/**\/*.jsonl` and `~/.codex/sessions/**\/*.jsonl`
+ * for live writes. Re-ingests changed files (debounced 300ms) and emits
+ * `'session-updated'` so the dashboard can refresh.
+ *
+ * Construction is cheap — call `.start()` after `buildIndex` finishes so we
+ * don't race with the initial bulk ingest.
+ */
+export class TailWatcher extends EventEmitter {
+    db;
+    roots;
+    stmts;
+    pricingMap;
+    watchers = [];
+    timers = new Map();
+    inFlight = new Map();
+    started = false;
+    closed = false;
+    constructor(db, roots) {
+        super();
+        this.db = db;
+        this.roots = roots;
+        // Prepare once — statements and pricing map are reusable across ingests.
+        this.stmts = prepareIngestStatements(db);
+        this.pricingMap = loadPricingMap(db);
+    }
+    /**
+     * Begin watching. Safe to call once. With `ignoreInitial: true` chokidar
+     * skips the existing tree and only fires on subsequent add/change events.
+     */
+    start() {
+        if (this.started || this.closed)
+            return;
+        this.started = true;
+        for (const root of this.roots) {
+            // chokidar v4 dropped glob support — watch the dir and filter via `ignored`.
+            const watcher = chokidar.watch(root.rootDir, {
+                ignoreInitial: true,
+                persistent: true,
+                ignored: (path, stats) => !!stats?.isFile() && !path.endsWith('.jsonl'),
+            });
+            const onChange = (path) => this.schedule(path, root.platform);
+            watcher.on('add', onChange);
+            watcher.on('change', onChange);
+            watcher.on('error', (err) => {
+                console.error('[vyasa] tail watcher error:', err);
+            });
+            this.watchers.push(watcher);
+        }
+    }
+    /** Debounce per-path so burst writes during a single turn coalesce into one ingest. */
+    schedule(path, platform) {
+        const existing = this.timers.get(path);
+        if (existing)
+            clearTimeout(existing);
+        const timer = setTimeout(() => {
+            this.timers.delete(path);
+            // Serialize per-path: if an ingest for this file is still running, queue
+            // ours after it instead of racing two parses of the same file in parallel
+            // (the later one would clobber the earlier one with possibly-stale data).
+            const previous = this.inFlight.get(path) ?? Promise.resolve();
+            const next = previous.catch(() => { }).then(() => this.ingest(path, platform));
+            this.inFlight.set(path, next);
+            void next.finally(() => {
+                if (this.inFlight.get(path) === next)
+                    this.inFlight.delete(path);
+            });
+        }, DEBOUNCE_MS);
+        this.timers.set(path, timer);
+    }
+    async ingest(path, platform) {
+        if (this.closed)
+            return;
+        try {
+            let mtimeMs;
+            try {
+                mtimeMs = statSync(path).mtimeMs;
+            }
+            catch {
+                // File was removed between event and ingest — nothing to do.
+                return;
+            }
+            const parse = platform === 'codex' ? parseCodex : parseJsonl;
+            const parsed = await parse(path);
+            if (!parsed.sessionId)
+                return;
+            this.db.transaction(() => ingestFromParsed(this.db, this.stmts, this.pricingMap, path, mtimeMs, platform, parsed))();
+            const event = { sessionId: parsed.sessionId, platform, path };
+            this.emit('session-updated', event);
+        }
+        catch (err) {
+            indexProgress.recordError();
+            console.error(`[vyasa] tail ingest failed for ${path}:`, err);
+        }
+    }
+    async close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        for (const timer of this.timers.values())
+            clearTimeout(timer);
+        this.timers.clear();
+        // Drain in-flight ingests so we don't write to a closed DB after shutdown.
+        await Promise.allSettled([...this.inFlight.values()]);
+        this.inFlight.clear();
+        await Promise.all(this.watchers.map((w) => w.close()));
+        this.watchers = [];
+        this.removeAllListeners();
+    }
+}
+//# sourceMappingURL=tail.js.map

package/dist/core/index/tail.js.map

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

package/dist/core/jsonl/index.d.ts

@@ -0,0 +1,3 @@
+import type { ParsedSession } from '../schema/index.js';
+export declare function parseJsonl(filePath: string): Promise<ParsedSession>;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/jsonl/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/jsonl/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,aAAa,EAKd,MAAM,oBAAoB,CAAA;AAM3B,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAuGzE"}

package/dist/core/jsonl/index.js

@@ -0,0 +1,106 @@
+import { createReadStream } from 'node:fs';
+import { createInterface } from 'node:readline';
+import { assertString } from '../jsonl-validate/index.js';
+import { recordFingerprint } from '../schema-watch/index.js';
+const SKIP_TYPES = new Set(['queue-operation', 'attachment', 'last-prompt']);
+export async function parseJsonl(filePath) {
+    const records = [];
+    const parseErrors = [];
+    const fingerprints = new Map();
+    let sessionId = null;
+    let startedAt = null;
+    let endedAt = null;
+    let claudeCustomTitle = null;
+    let claudeAiTitle = null;
+    let lineNum = 0;
+    const rl = createInterface({
+        input: createReadStream(filePath, { encoding: 'utf8' }),
+        crlfDelay: Infinity,
+    });
+    for await (const line of rl) {
+        lineNum++;
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        let raw;
+        try {
+            raw = JSON.parse(trimmed);
+        }
+        catch {
+            // skip malformed lines silently (JSON parse error — no record type to report)
+            continue;
+        }
+        const type = raw['type'];
+        if (!type || SKIP_TYPES.has(type))
+            continue;
+        // Derive sessionId from first record that has one
+        if (!sessionId && typeof raw['sessionId'] === 'string') {
+            sessionId = raw['sessionId'];
+        }
+        // Capture Claude-native session names (latest-wins). These are standalone metadata
+        // records, NOT conversation turns — do not push into `records` (would inflate counts).
+        // No `continue`: let them fall through to recordFingerprint below (the type branches
+        // skip them) so schema-drift detection still observes these record shapes.
+        if (type === 'custom-title' && typeof raw['customTitle'] === 'string')
+            claudeCustomTitle = raw['customTitle'];
+        if (type === 'ai-title' && typeof raw['aiTitle'] === 'string')
+            claudeAiTitle = raw['aiTitle'];
+        try {
+            // Collect fingerprint for drift detection (before type-specific handling)
+            const fp = recordFingerprint(raw);
+            if (!fingerprints.has(fp)) {
+                fingerprints.set(fp, { firstSeenLine: lineNum });
+            }
+            if (type === 'user') {
+                // Validate the type field with assertString (validates the role field inside message)
+                const msgObj = raw['message'];
+                if (msgObj) {
+                    assertString(msgObj['role'], `line ${lineNum}: message.role`);
+                }
+                // `toolUseResult` (top-level, sibling to message — carries durationMs for some tools) and
+                // `permissionMode` ride through the cast since they're top-level keys on the raw record.
+                // is_error lives on the tool_result content block, already typed on ContentBlock.
+                const record = raw;
+                records.push(record);
+                if (startedAt === null) {
+                    startedAt = record.timestamp;
+                }
+                endedAt = record.timestamp;
+            }
+            else if (type === 'assistant') {
+                const record = raw;
+                records.push(record);
+                endedAt = record.timestamp;
+            }
+            else if (type === 'system') {
+                const record = raw;
+                records.push(record);
+                endedAt = record.timestamp;
+            }
+        }
+        catch (e) {
+            parseErrors.push({
+                lineNum,
+                recordType: type ?? null,
+                error: e.message,
+                sampleJson: trimmed.slice(0, 200),
+            });
+            continue;
+        }
+    }
+    const usageRecords = records.filter((r) => r.type === 'assistant' && r.message.usage != null);
+    return {
+        sessionId,
+        filePath,
+        project: null,
+        records,
+        usageRecords,
+        startedAt,
+        endedAt,
+        claudeCustomTitle,
+        claudeAiTitle,
+        parseErrors,
+        fingerprints,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/core/jsonl/index.js.map

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

package/dist/core/jsonl-validate/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Runtime validators for JSONL record fields.
+ * Used by both the Claude (src/core/jsonl) and Codex (src/core/codex) parsers.
+ */
+export declare function assertString(v: unknown, ctx: string): string;
+export declare function assertObject(v: unknown, ctx: string): Record<string, unknown>;
+export declare function assertOneOf<T extends string>(v: unknown, allowed: readonly T[], ctx: string): T;
+export declare function optionalString(v: unknown, ctx: string): string | undefined;
+export declare function optionalNumber(v: unknown, ctx: string): number | undefined;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/jsonl-validate/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/jsonl-validate/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,wBAAgB,YAAY,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAK5D;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAM7E;AAED,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,EAC1C,CAAC,EAAE,OAAO,EACV,OAAO,EAAE,SAAS,CAAC,EAAE,EACrB,GAAG,EAAE,MAAM,GACV,CAAC,CAQH;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG1E;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAM1E"}

package/dist/core/jsonl-validate/index.js

@@ -0,0 +1,40 @@
+/**
+ * Runtime validators for JSONL record fields.
+ * Used by both the Claude (src/core/jsonl) and Codex (src/core/codex) parsers.
+ */
+export function assertString(v, ctx) {
+    if (typeof v !== 'string') {
+        throw new Error(`${ctx}: expected string, got ${typeof v}`);
+    }
+    return v;
+}
+export function assertObject(v, ctx) {
+    if (v === null || typeof v !== 'object' || Array.isArray(v)) {
+        const got = v === null ? 'null' : Array.isArray(v) ? 'array' : typeof v;
+        throw new Error(`${ctx}: expected object, got ${got}`);
+    }
+    return v;
+}
+export function assertOneOf(v, allowed, ctx) {
+    if (typeof v !== 'string') {
+        throw new Error(`${ctx}: expected string, got ${typeof v}`);
+    }
+    if (!allowed.includes(v)) {
+        throw new Error(`${ctx}: expected one of [${allowed.join(', ')}], got "${v}"`);
+    }
+    return v;
+}
+export function optionalString(v, ctx) {
+    if (v === null || v === undefined)
+        return undefined;
+    return assertString(v, ctx);
+}
+export function optionalNumber(v, ctx) {
+    if (v === null || v === undefined)
+        return undefined;
+    if (typeof v !== 'number') {
+        throw new Error(`${ctx}: expected number, got ${typeof v}`);
+    }
+    return v;
+}
+//# sourceMappingURL=index.js.map

package/dist/core/jsonl-validate/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/jsonl-validate/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,UAAU,YAAY,CAAC,CAAU,EAAE,GAAW;IAClD,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,GAAG,GAAG,0BAA0B,OAAO,CAAC,EAAE,CAAC,CAAA;IAC7D,CAAC;IACD,OAAO,CAAC,CAAA;AACV,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,CAAU,EAAE,GAAW;IAClD,IAAI,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5D,MAAM,GAAG,GAAG,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;QACvE,MAAM,IAAI,KAAK,CAAC,GAAG,GAAG,0BAA0B,GAAG,EAAE,CAAC,CAAA;IACxD,CAAC;IACD,OAAO,CAA4B,CAAA;AACrC,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,CAAU,EACV,OAAqB,EACrB,GAAW;IAEX,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,GAAG,GAAG,0BAA0B,OAAO,CAAC,EAAE,CAAC,CAAA;IAC7D,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAM,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,GAAG,GAAG,sBAAsB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAA;IAChF,CAAC;IACD,OAAO,CAAM,CAAA;AACf,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,CAAU,EAAE,GAAW;IACpD,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,SAAS;QAAE,OAAO,SAAS,CAAA;IACnD,OAAO,YAAY,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;AAC7B,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,CAAU,EAAE,GAAW;IACpD,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,SAAS;QAAE,OAAO,SAAS,CAAA;IACnD,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,GAAG,GAAG,0BAA0B,OAAO,CAAC,EAAE,CAAC,CAAA;IAC7D,CAAC;IACD,OAAO,CAAC,CAAA;AACV,CAAC"}

package/dist/core/kit/detection.d.ts

@@ -0,0 +1,94 @@
+import Database from 'better-sqlite3';
+import type { SkillState, McpState, GapItem, ZombieItem } from '../schema/index.js';
+interface ToolUsageRow {
+    tool: string;
+    input_json: string | null;
+    ts: string;
+}
+/**
+ * Returns per-skill usage statistics over the lookback window.
+ * Skill firings are tool_calls with tool='Skill' and input_json containing
+ *   {"skill": "<plugin>:<name>"}  (plugin-installed)
+ *   {"skill": "<name>"}            (loose)
+ * The canonical id from the call is the join key.
+ */
+export declare function loadSkillUsage(db: Database.Database, lookbackDays: number): Map<string, {
+    count: number;
+    lastUsedMs: number;
+}>;
+/**
+ * Returns per-MCP-server usage statistics over the lookback window. Server
+ * name is the token between the first two '__' in the tool name (e.g.
+ * `mcp__chrome-devtools__navigate_page` → 'chrome-devtools').
+ */
+export declare function loadMcpUsage(db: Database.Database, lookbackDays: number): Map<string, {
+    count: number;
+    lastUsedMs: number;
+}>;
+/**
+ * Returns every non-Skill, non-MCP tool_call in the window paired with its
+ * input_json. Used by the gap detector to grep for "replaces" patterns.
+ * Limited to the tool names we currently emit patterns against, to avoid
+ * pulling 100K+ Read/Edit rows.
+ */
+export declare function loadCandidateToolCalls(db: Database.Database, lookbackDays: number, toolFilter: string[]): ToolUsageRow[];
+/**
+ * Annotates each SkillState with its usage stats from the tool_calls table.
+ *
+ * Plugin skills can fire under EITHER '<plugin>:<name>' OR bare '<name>' depending
+ * on how the user invoked them — verified in real data (e.g. `update-config`
+ * appears as bare even though it's plugin-bundled). Merge both keys so we don't
+ * surface false-positive zombies for skills that are actually being used.
+ */
+export declare function hydrateSkillUsage(skills: SkillState[], usage: Map<string, {
+    count: number;
+    lastUsedMs: number;
+}>): SkillState[];
+export declare function hydrateMcpUsage(mcps: McpState[], usage: Map<string, {
+    count: number;
+    lastUsedMs: number;
+}>): McpState[];
+export interface CommonKitSkill {
+    id: string;
+    purpose: string;
+    install: string;
+}
+export interface CommonKitMcp {
+    id: string;
+    purpose: string;
+    install: string;
+    /** Tool-pattern strings: "<tool>:<pattern>". `tool` matches tool_calls.tool exactly. */
+    replaces?: string[];
+}
+export interface CommonKit {
+    version: number;
+    skills: CommonKitSkill[];
+    mcpServers: CommonKitMcp[];
+}
+/**
+ * For each common-kit item not already installed, build a GapItem. For MCP
+ * gaps, count tool_calls matching the `replaces` patterns over the lookback
+ * window — these are loosely the calls an MCP server would handle directly,
+ * eliminating the need for shelling out / fetching.
+ *
+ * Savings heuristic for MCP: we currently surface the match count as a
+ * "potential reduction" signal (rendered in the UI as "N calls would be
+ * replaced") but do NOT compute dollar savings — Bash/WebFetch cost lives in
+ * the assistant's output tokens around the call, which we don't attribute
+ * per-tool. So potentialSavingsCents stays 0 in V1 unless the kit grows entries
+ * with a model-aware estimate; matchingCallCount is the actionable number.
+ */
+export declare function detectGaps(kit: CommonKit, installedSkillIds: Set<string>, installedMcpIds: Set<string>, candidateCalls: ToolUsageRow[]): GapItem[];
+/** Returns the union of tool names referenced by the kit's `replaces` patterns. */
+export declare function collectReplacedTools(kit: CommonKit): string[];
+/**
+ * A skill or MCP server is a "zombie" when it's installed on the filesystem
+ * but has not been invoked in the lookback window. We treat usageCount=0 as
+ * the threshold (the spec mentions "below threshold like 2 over 30d for skills"
+ * — but for V1 we use the strict zero gate since the user has few-to-no skills
+ * installed, and a single intentional use is enough to "save" a skill from the
+ * list).
+ */
+export declare function detectZombies(skills: SkillState[], mcp: McpState[]): ZombieItem[];
+export {};
+//# sourceMappingURL=detection.d.ts.map

package/dist/core/kit/detection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detection.d.ts","sourceRoot":"","sources":["../../../src/core/kit/detection.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAA;AACrC,OAAO,KAAK,EACV,UAAU,EACV,QAAQ,EACR,OAAO,EACP,UAAU,EACX,MAAM,oBAAoB,CAAA;AAgB3B,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,EAAE,EAAE,MAAM,CAAA;CACX;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,YAAY,EAAE,MAAM,GACnB,GAAG,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAuCpD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,YAAY,EAAE,MAAM,GACnB,GAAG,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAiCpD;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAAE,GACnB,YAAY,EAAE,CAchB;AAID;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,UAAU,EAAE,EACpB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,GACxD,UAAU,EAAE,CASd;AAED,wBAAgB,eAAe,CAC7B,IAAI,EAAE,QAAQ,EAAE,EAChB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,GACxD,QAAQ,EAAE,CAMZ;AAID,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,wFAAwF;IACxF,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,cAAc,EAAE,CAAA;IACxB,UAAU,EAAE,YAAY,EAAE,CAAA;CAC3B;AAiBD;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CACxB,GAAG,EAAE,SAAS,EACd,iBAAiB,EAAE,GAAG,CAAC,MAAM,CAAC,EAC9B,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,EAC5B,cAAc,EAAE,YAAY,EAAE,GAC7B,OAAO,EAAE,CAqDX;AAED,mFAAmF;AACnF,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,SAAS,GAAG,MAAM,EAAE,CAS7D;AAID;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,UAAU,EAAE,EACpB,GAAG,EAAE,QAAQ,EAAE,GACd,UAAU,EAAE,CAmCd"}