@sashabogi/foundation 2.1.0 → 2.3.1

package/dist/tools/gaia/transcript-ingester.js

@@ -0,0 +1,418 @@
+/**
+ * Transcript Ingester
+ *
+ * Walks ~/.claude/projects/**‌/*.jsonl, parses Claude Code conversation
+ * transcripts, and indexes human + assistant prose into Gaia's FTS5 store.
+ *
+ * Design:
+ * - Streams JSONL line-by-line (never loads full file into memory)
+ * - Incremental: tracks last-ingested byte offset per file in SQLite
+ * - Dedupes on (file_path, message_index) to survive re-runs
+ * - Skips noise: tool_result, system messages, sidechain, pure tool_use-only turns
+ */
+import { createReadStream, existsSync, readdirSync, statSync } from 'fs';
+import { join, basename } from 'path';
+import { homedir } from 'os';
+import { createInterface } from 'readline';
+import { nanoid } from 'nanoid';
+// =============================================================================
+// Schema helpers — call against the MemoriaStorage db instance (accessed via
+// the exposed `getDb` accessor we add to storage, or by passing db directly)
+// =============================================================================
+export const INGEST_STATE_DDL = `
+  CREATE TABLE IF NOT EXISTS transcript_ingest_state (
+    file_path TEXT NOT NULL PRIMARY KEY,
+    last_byte_offset INTEGER NOT NULL DEFAULT 0,
+    last_ingested_at INTEGER NOT NULL,
+    messages_ingested INTEGER NOT NULL DEFAULT 0
+  );
+
+  CREATE TABLE IF NOT EXISTS transcript_dedup (
+    file_path TEXT NOT NULL,
+    message_index INTEGER NOT NULL,
+    memory_id TEXT NOT NULL,
+    PRIMARY KEY (file_path, message_index)
+  );
+
+  CREATE INDEX IF NOT EXISTS idx_dedup_file ON transcript_dedup(file_path);
+`;
+// =============================================================================
+// JSONL parsing helpers
+// =============================================================================
+/**
+ * Extract plain text from Claude Code message content.
+ * Content may be a plain string or an array of content blocks.
+ * We only keep `text` blocks — tool_use and tool_result blocks are dropped.
+ */
+function extractText(content) {
+    if (typeof content === 'string') {
+        const trimmed = content.trim();
+        return trimmed.length > 0 ? trimmed : null;
+    }
+    if (!Array.isArray(content))
+        return null;
+    const parts = [];
+    for (const block of content) {
+        if (typeof block !== 'object' || block === null)
+            continue;
+        const b = block;
+        if (b['type'] === 'text' && typeof b['text'] === 'string') {
+            const t = b['text'].trim();
+            if (t.length > 0)
+                parts.push(t);
+        }
+        // Explicitly skip: tool_use, tool_result, image, document, etc.
+    }
+    return parts.length > 0 ? parts.join('\n\n') : null;
+}
+/**
+ * Parse a single JSONL line into a ParsedMessage or null if it should be
+ * skipped (noise, metadata, sidechain, system).
+ */
+function parseLine(rawLine, lineIndex, filePath, projectSlug, sinceMs) {
+    let obj;
+    try {
+        obj = JSON.parse(rawLine);
+    }
+    catch {
+        return null;
+    }
+    const type = obj['type'];
+    // Only process user + assistant prose turns
+    if (type !== 'user' && type !== 'assistant')
+        return null;
+    // Skip sidechain messages (sub-agent internal turns)
+    if (obj['isSidechain'] === true)
+        return null;
+    // Require a message wrapper
+    const msg = obj['message'];
+    if (typeof msg !== 'object' || msg === null)
+        return null;
+    const msgObj = msg;
+    const role = msgObj['role'];
+    if (role !== 'user' && role !== 'assistant')
+        return null;
+    const text = extractText(msgObj['content']);
+    if (!text)
+        return null;
+    // Parse timestamp — field is "timestamp" on both user and assistant rows
+    let timestamp = 0;
+    const ts = obj['timestamp'];
+    if (typeof ts === 'string') {
+        const parsed = Date.parse(ts);
+        if (!isNaN(parsed))
+            timestamp = parsed;
+    }
+    else if (typeof ts === 'number') {
+        timestamp = ts;
+    }
+    // Since filter
+    if (sinceMs !== null && timestamp > 0 && timestamp < sinceMs)
+        return null;
+    const sessionId = typeof obj['sessionId'] === 'string' ? obj['sessionId'] : 'unknown';
+    const cwd = typeof obj['cwd'] === 'string' ? obj['cwd'] : null;
+    return {
+        sessionId,
+        messageIndex: lineIndex,
+        timestamp,
+        role: role,
+        text,
+        projectSlug,
+        cwd,
+        filePath,
+        lineOffset: lineIndex,
+    };
+}
+// =============================================================================
+// Project slug extraction
+// =============================================================================
+/**
+ * Derive human-readable project name from the JSONL path.
+ * ~/.claude/projects/<slug>/<uuid>.jsonl → slug
+ */
+function slugFromPath(filePath, rootDir) {
+    // Strip rootDir prefix
+    const relative = filePath.startsWith(rootDir)
+        ? filePath.slice(rootDir.length + 1)
+        : filePath;
+    // First path component is the project slug
+    const slug = relative.split('/')[0] ?? basename(filePath);
+    return slug;
+}
+// =============================================================================
+// Core ingester
+// =============================================================================
+export class TranscriptIngester {
+    db;
+    memoria;
+    constructor(memoriaDb, memoria) {
+        this.db = memoriaDb;
+        this.memoria = memoria;
+        this.ensureSchema();
+    }
+    ensureSchema() {
+        this.db.exec(INGEST_STATE_DDL);
+    }
+    // ---------------------------------------------------------------------------
+    // Public API
+    // ---------------------------------------------------------------------------
+    async ingest(options = {}) {
+        const { rootDir = join(homedir(), '.claude', 'projects'), projectFilter, since, dryRun = false, } = options;
+        const sinceMs = since ? Date.parse(since) : null;
+        if (since && (sinceMs === null || isNaN(sinceMs))) {
+            throw new Error(`Invalid since timestamp: ${since}`);
+        }
+        const stats = {
+            filesFound: 0,
+            filesSkipped: 0,
+            messagesIngested: 0,
+            messagesSkipped: 0,
+            bytesProcessed: 0,
+            projectSlugs: [],
+            dateRange: { earliest: null, latest: null },
+            parseErrors: 0,
+            parseErrorSamples: [],
+            dryRun,
+        };
+        if (!existsSync(rootDir)) {
+            return stats;
+        }
+        // Walk rootDir/slug/*.jsonl
+        const slugSet = new Set();
+        const jsonlFiles = this.collectJsonlFiles(rootDir, projectFilter);
+        for (const filePath of jsonlFiles) {
+            const slug = slugFromPath(filePath, rootDir);
+            slugSet.add(slug);
+            stats.filesFound++;
+            try {
+                await this.processFile(filePath, slug, sinceMs, dryRun, stats);
+            }
+            catch (err) {
+                stats.parseErrors++;
+                if (stats.parseErrorSamples.length < 3) {
+                    stats.parseErrorSamples.push(`${filePath}: ${err instanceof Error ? err.message : String(err)}`);
+                }
+            }
+        }
+        stats.projectSlugs = Array.from(slugSet).sort();
+        return stats;
+    }
+    // ---------------------------------------------------------------------------
+    // File collection
+    // ---------------------------------------------------------------------------
+    collectJsonlFiles(rootDir, projectFilter) {
+        const results = [];
+        let slugDirs;
+        try {
+            slugDirs = readdirSync(rootDir);
+        }
+        catch {
+            return results;
+        }
+        for (const slug of slugDirs) {
+            if (projectFilter && !slug.includes(projectFilter))
+                continue;
+            const slugPath = join(rootDir, slug);
+            let isDir = false;
+            try {
+                isDir = statSync(slugPath).isDirectory();
+            }
+            catch {
+                continue;
+            }
+            if (!isDir)
+                continue;
+            let entries;
+            try {
+                entries = readdirSync(slugPath);
+            }
+            catch {
+                continue;
+            }
+            for (const entry of entries) {
+                if (entry.endsWith('.jsonl')) {
+                    results.push(join(slugPath, entry));
+                }
+            }
+        }
+        return results;
+    }
+    // ---------------------------------------------------------------------------
+    // Per-file processing
+    // ---------------------------------------------------------------------------
+    async processFile(filePath, projectSlug, sinceMs, dryRun, stats) {
+        // Get last known offset for incremental processing
+        const stateRow = this.db.prepare(`SELECT last_byte_offset FROM transcript_ingest_state WHERE file_path = ?`).get(filePath);
+        const startOffset = stateRow?.last_byte_offset ?? 0;
+        // Get current file size to determine if there's new content
+        let fileSize = 0;
+        try {
+            fileSize = statSync(filePath).size;
+        }
+        catch {
+            stats.filesSkipped++;
+            return;
+        }
+        if (fileSize <= startOffset) {
+            stats.filesSkipped++;
+            return;
+        }
+        // Stream the file from start (we need to track line indices from 0 for dedup)
+        const messages = await this.streamFile(filePath, projectSlug, sinceMs, startOffset, stats);
+        if (messages.length === 0) {
+            // Update state even if no messages were parseable (to advance offset)
+            if (!dryRun) {
+                this.updateIngestState(filePath, fileSize, 0);
+            }
+            return;
+        }
+        if (dryRun) {
+            stats.messagesIngested += messages.length;
+            this.updateDateRange(stats, messages);
+            return;
+        }
+        // Insert in a transaction for atomicity
+        const insertCount = this.db.transaction(() => {
+            let inserted = 0;
+            for (const msg of messages) {
+                // Check dedup
+                const exists = this.db.prepare(`SELECT 1 FROM transcript_dedup WHERE file_path = ? AND message_index = ?`).get(msg.filePath, msg.messageIndex);
+                if (exists) {
+                    stats.messagesSkipped++;
+                    continue;
+                }
+                // Build memory content — prefix with role for search quality
+                const roleLabel = msg.role === 'user' ? '[User]' : '[Assistant]';
+                const content = `${roleLabel} ${msg.text}`;
+                // Save into Gaia memory store
+                const memory = this.memoria.saveMemory({
+                    tier: 'project',
+                    content,
+                    tags: ['transcript', msg.role, msg.projectSlug],
+                    related_files: [],
+                    session_id: msg.sessionId,
+                    project_path: msg.cwd ?? msg.projectSlug,
+                    metadata: {
+                        source: 'transcript',
+                        session_id: msg.sessionId,
+                        message_index: msg.messageIndex,
+                        role: msg.role,
+                        project_slug: msg.projectSlug,
+                        file_path: msg.filePath,
+                        line_offset: msg.lineOffset,
+                        original_timestamp: msg.timestamp > 0 ? new Date(msg.timestamp).toISOString() : null,
+                    },
+                });
+                // Record dedup entry
+                this.db.prepare(`INSERT OR IGNORE INTO transcript_dedup (file_path, message_index, memory_id) VALUES (?, ?, ?)`).run(msg.filePath, msg.messageIndex, memory.id);
+                inserted++;
+                stats.messagesIngested++;
+            }
+            return inserted;
+        })();
+        // Update incremental state to the current file size
+        this.updateIngestState(filePath, fileSize, insertCount);
+        this.updateDateRange(stats, messages);
+        stats.bytesProcessed += fileSize - startOffset;
+    }
+    // ---------------------------------------------------------------------------
+    // Streaming JSONL parser
+    // ---------------------------------------------------------------------------
+    streamFile(filePath, projectSlug, sinceMs, startOffset, stats) {
+        return new Promise((resolve, reject) => {
+            const messages = [];
+            // We always read from byte 0 to maintain correct lineIndex for dedup.
+            // Lines before startOffset are checked against dedup table and skipped
+            // in processFile, but we need their indices. For very large files already
+            // fully ingested, startOffset == fileSize so we return early above.
+            // The cost here is line counting from the start — acceptable since we
+            // only reach this if there's new content beyond the last offset.
+            const stream = createReadStream(filePath, { encoding: 'utf8' });
+            const rl = createInterface({ input: stream, crlfDelay: Infinity });
+            let lineIndex = 0;
+            let currentByteOffset = 0;
+            rl.on('line', (rawLine) => {
+                const lineByteLength = Buffer.byteLength(rawLine + '\n', 'utf8');
+                const lineStartOffset = currentByteOffset;
+                currentByteOffset += lineByteLength;
+                // Lines within already-ingested region: skip parsing but increment index
+                if (currentByteOffset <= startOffset) {
+                    lineIndex++;
+                    return;
+                }
+                // Parse line
+                let parsed = null;
+                try {
+                    parsed = parseLine(rawLine, lineIndex, filePath, projectSlug, sinceMs);
+                }
+                catch (err) {
+                    stats.parseErrors++;
+                    if (stats.parseErrorSamples.length < 3) {
+                        stats.parseErrorSamples.push(`${filePath}:${lineIndex}: ${err instanceof Error ? err.message : String(err)}`);
+                    }
+                }
+                if (parsed) {
+                    messages.push(parsed);
+                }
+                lineIndex++;
+            });
+            rl.on('close', () => resolve(messages));
+            rl.on('error', reject);
+            stream.on('error', reject);
+        });
+    }
+    // ---------------------------------------------------------------------------
+    // State tracking
+    // ---------------------------------------------------------------------------
+    updateIngestState(filePath, byteOffset, inserted) {
+        this.db.prepare(`
+      INSERT INTO transcript_ingest_state (file_path, last_byte_offset, last_ingested_at, messages_ingested)
+      VALUES (?, ?, ?, ?)
+      ON CONFLICT(file_path) DO UPDATE SET
+        last_byte_offset = excluded.last_byte_offset,
+        last_ingested_at = excluded.last_ingested_at,
+        messages_ingested = messages_ingested + excluded.messages_ingested
+    `).run(filePath, byteOffset, Date.now(), inserted);
+    }
+    updateDateRange(stats, messages) {
+        for (const msg of messages) {
+            if (msg.timestamp <= 0)
+                continue;
+            const iso = new Date(msg.timestamp).toISOString();
+            if (!stats.dateRange.earliest || iso < stats.dateRange.earliest) {
+                stats.dateRange.earliest = iso;
+            }
+            if (!stats.dateRange.latest || iso > stats.dateRange.latest) {
+                stats.dateRange.latest = iso;
+            }
+        }
+    }
+    // ---------------------------------------------------------------------------
+    // Utility: exposed for tests
+    // ---------------------------------------------------------------------------
+    /** Returns ingest state rows for testing incremental behavior */
+    getIngestState() {
+        return this.db.prepare(`SELECT file_path, last_byte_offset, messages_ingested FROM transcript_ingest_state`).all();
+    }
+    /** Returns dedup row count for a given file */
+    getDedupCount(filePath) {
+        const row = this.db.prepare(`SELECT COUNT(*) as count FROM transcript_dedup WHERE file_path = ?`).get(filePath);
+        return row.count;
+    }
+    /** Nano-id helper (re-exported so tests can use it) */
+    static generateId() {
+        return `mem_${nanoid()}`;
+    }
+}
+// =============================================================================
+// Standalone helper: build a TranscriptIngester from an existing MemoriaStorage
+// =============================================================================
+/**
+ * MemoriaStorage keeps its `db` private. We expose it through this module
+ * by accepting the db instance directly (tests pass an in-memory DB;
+ * the MCP tool passes the real db through getInternalDb).
+ */
+export function createIngester(db, memoria) {
+    return new TranscriptIngester(db, memoria);
+}
+//# sourceMappingURL=transcript-ingester.js.map

package/dist/tools/gaia/transcript-ingester.js.map

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

package/dist/vault/dashboard.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Vault Dashboard Generator
+ *
+ * Generates an Obsidian-compatible markdown file with Dataview plugin queries.
+ * The resulting file is written to Foundation/_dashboard.md inside the vault.
+ * Dataview handles all dynamic querying at render time — this function only
+ * produces the static template with embedded query blocks.
+ */
+export declare function generateDashboard(): string;
+//# sourceMappingURL=dashboard.d.ts.map

package/dist/vault/dashboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.d.ts","sourceRoot":"","sources":["../../src/vault/dashboard.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,wBAAgB,iBAAiB,IAAI,MAAM,CAqI1C"}

package/dist/vault/dashboard.js

@@ -0,0 +1,145 @@
+/**
+ * Vault Dashboard Generator
+ *
+ * Generates an Obsidian-compatible markdown file with Dataview plugin queries.
+ * The resulting file is written to Foundation/_dashboard.md inside the vault.
+ * Dataview handles all dynamic querying at render time — this function only
+ * produces the static template with embedded query blocks.
+ */
+// =============================================================================
+// Dashboard Generator
+// =============================================================================
+export function generateDashboard() {
+    const timestamp = new Date().toISOString();
+    return `# Foundation Memory Dashboard
+> Auto-generated by \`foundation vault sync\`. Do not edit manually.
+> Last sync: ${timestamp}
+
+---
+
+## Overview Stats
+
+\`\`\`dataviewjs
+const pages = dv.pages('"Foundation"').where(p => p.tier);
+const tiers = ["session", "project", "global", "note", "observation"];
+
+const rows = tiers.map(tier => {
+  const matches = pages.where(p => p.tier === tier);
+  const latest = matches.sort(p => p.created, "desc").first();
+  return [
+    tier,
+    matches.length,
+    latest ? latest.created : "—"
+  ];
+}).filter(r => r[1] > 0);
+
+dv.table(["Tier", "Count", "Latest Memory"], rows);
+\`\`\`
+
+---
+
+## Recently Accessed
+
+\`\`\`dataview
+TABLE tier, tags, accessed, access_count
+FROM "Foundation"
+WHERE accessed != null
+SORT accessed DESC
+LIMIT 15
+\`\`\`
+
+---
+
+## Most Connected
+
+\`\`\`dataviewjs
+const pages = dv.pages('"Foundation"');
+
+const rows = pages
+  .map(p => {
+    const content = p.file.content ?? "";
+    const linkCount = (content.match(/\[\[/g) ?? []).length;
+    return [p.file.link, p.tier ?? "—", linkCount];
+  })
+  .sort(r => r[2], "desc")
+  .slice(0, 20);
+
+dv.table(["Memory", "Tier", "Link Count"], rows);
+\`\`\`
+
+---
+
+## Contradictions & Reverts
+
+> Memories flagged with **contradicts** or **reverts** links — require human review.
+
+\`\`\`dataviewjs
+const pages = dv.pages('"Foundation"');
+
+const flagged = pages.filter(p => {
+  const content = p.file.content ?? "";
+  return content.includes("**contradicts**") || content.includes("**reverts**");
+});
+
+if (flagged.length === 0) {
+  dv.paragraph("No contradictions or reverts detected.");
+} else {
+  dv.list(flagged.map(p => p.file.link));
+}
+\`\`\`
+
+---
+
+## By Project
+
+\`\`\`dataview
+TABLE rows.file.link AS "Memories", length(rows) AS "Count"
+FROM "Foundation"
+WHERE project != null
+GROUP BY project
+SORT length(rows) DESC
+\`\`\`
+
+---
+
+## Tag Cloud
+
+\`\`\`dataviewjs
+const pages = dv.pages('"Foundation"');
+
+const tagCounts = {};
+for (const page of pages) {
+  for (const tag of (page.tags ?? [])) {
+    tagCounts[tag] = (tagCounts[tag] ?? 0) + 1;
+  }
+}
+
+const sorted = Object.entries(tagCounts)
+  .sort((a, b) => b[1] - a[1]);
+
+dv.list(sorted.map(([tag, count]) => \`\${tag} — \${count}\`));
+\`\`\`
+
+---
+
+## Recent Sessions
+
+\`\`\`dataview
+TABLE tier, tags, created, access_count
+FROM "Foundation/Sessions"
+SORT created DESC
+LIMIT 20
+\`\`\`
+
+---
+
+## Knowledge Base
+
+\`\`\`dataview
+TABLE type, description
+FROM "Knowledge"
+SORT file.name ASC
+\`\`\`
+`;
+}
+//# sourceMappingURL=dashboard.js.map

package/dist/vault/dashboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.js","sourceRoot":"","sources":["../../src/vault/dashboard.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,gFAAgF;AAChF,sBAAsB;AACtB,gFAAgF;AAEhF,MAAM,UAAU,iBAAiB;IAC/B,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAE3C,OAAO;;eAEM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+HvB,CAAC;AACF,CAAC"}

package/dist/vault/sync.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Vault Sync Engine
+ *
+ * Syncs Gaia memories from SQLite to an Obsidian vault as interlinked
+ * markdown files. Supports full and incremental sync, Claude Code memory
+ * file ingestion, and orphan cleanup.
+ */
+export interface VaultConfig {
+    /** Absolute path to the Obsidian vault root. */
+    vaultPath: string;
+    /** Absolute path to the Gaia SQLite database. */
+    gaiaDbPath: string;
+    /** Absolute path to the sync state JSON file. */
+    syncStatePath: string;
+    /** Optional path to Claude Code memory directory (e.g. ~/.claude/projects/.../memory/). */
+    claudeMemoryPath?: string;
+}
+export interface SyncState {
+    vault_path: string;
+    last_full_sync: string;
+    synced_memories: Record<string, string>;
+}
+export interface SyncResult {
+    created: number;
+    updated: number;
+    deleted: number;
+    skipped: number;
+    errors: string[];
+}
+export declare class VaultSync {
+    private config;
+    constructor(config: VaultConfig);
+    /**
+     * Create the required folder structure in the vault and write an initial
+     * dashboard index file.
+     */
+    init(): Promise<void>;
+    /**
+     * Full sync: reads ALL memories from Gaia DB, transforms and writes every
+     * file, updates sync state. Also syncs Claude Code memory files if
+     * claudeMemoryPath is configured.
+     */
+    sync(): Promise<SyncResult>;
+    /**
+     * Incremental sync: only writes memories whose rendered content has changed
+     * since the last sync (detected via MD5 hash comparison).
+     */
+    syncIncremental(): Promise<SyncResult>;
+    /**
+     * Returns the current sync state, or null if no sync has run yet.
+     */
+    getStatus(): SyncState | null;
+    private loadSyncState;
+    private saveSyncState;
+    private hashContent;
+    private syncGaiaMemories;
+    private syncClaudeMemories;
+    /**
+     * Walk Foundation/ in the vault and remove .md files whose memory id is no
+     * longer in currentIds. Returns the number of files deleted.
+     */
+    private cleanOrphans;
+}
+//# sourceMappingURL=sync.d.ts.map

package/dist/vault/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/vault/sync.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA0BH,MAAM,WAAW,WAAW;IAC1B,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,UAAU,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,aAAa,EAAE,MAAM,CAAC;IACtB,2FAA2F;IAC3F,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAoBD,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAc;gBAEhB,MAAM,EAAE,WAAW;IAQ/B;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAc3B;;;;OAIG;IACG,IAAI,IAAI,OAAO,CAAC,UAAU,CAAC;IAajC;;;OAGG;IACG,eAAe,IAAI,OAAO,CAAC,UAAU,CAAC;IAa5C;;OAEG;IACH,SAAS,IAAI,SAAS,GAAG,IAAI;IAa7B,OAAO,CAAC,aAAa;IAWrB,OAAO,CAAC,aAAa;IAarB,OAAO,CAAC,WAAW;YAQL,gBAAgB;YAwFhB,kBAAkB;IAoEhC;;;OAGG;IACH,OAAO,CAAC,YAAY;CA4DrB"}